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Related Documents In addition to this guide, you might be 

interested in four other related documents: 

. TurboDOS 1.4 Z80 Progra mm er's Guide 

. TurboDOS 1.4 Z80 Im ple m entor's Guide 


. TurboDOS JU4. 8086 Progra mm er's Gu id e 


. TurboDOS 1.4 8086 


G uid e 


You'll need the Progra mm er's Guide if you are 
writing applications programs to run under 
TurboDOS, especially if you are programming 
in assembly language. It explains the inter¬ 
nal workings of TurboDOS in much more detail 
than this document does, and describes each 
TurboDOS function in detail. 

You'll need the Im ple m entor*s Gui de if you 
are adapting TurboDOS to a new hardware con¬ 
figuration. It explains the system genera¬ 
tion and OEM distribution procedures, and 
also describes how to implement hardware- 
dependent driver modules. 
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ABOUT THIS GUIDE 


Purpose 

We've designed this User's Guide to make it 
easy for you to learn how to use the TurboDOS 
operating system. This document tells you 
what TurboDOS does, how to use its various 
facilities, and what to do in case of errors. 
It also describes each TurboDOS command in 
detail. The information presented applies 
to both Z80 and 8086 TurboDOS. 

Assumptions 

In writing this guide, we've assumed that you 
have a pr e-configured copy of TurboDOS all 
ready to run on your computer. Also, you 
need to know some basic things about your 
computer equipment: how to hook it up and 
start it running, and how to handle the disks 
it uses. We haven't assumed you are a pro¬ 
grammer or an experienced computer user, 
however. 

Organization 

This guide starts with a section that ex¬ 
plains some of the basics: what TurboDOS is, 
what it does, how to get it started, enter 
commands, and correct errors. 


The next three sections explain the principal 
concepts of TurboDOS in more detail. There 
are sections on files and disks, printing, 
and processing. 


There is a reference section that describes 
each TurboDOS command in detail. This sec¬ 
tion is organized alphabetically for easy 
reference. 


Finally, there is a glossary and an index. 
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SOME BASICS In this section you will learn what TurboDOS 

does, what kind of hardware it runs on, how 
to start it up, and how to enter commands and 
correct errors. 

Let's start with the obvious question... 


What is TurboDOS? TurboDOS is a collection of programs designed 

to make your computer run more efficiently, 
and to make it easier for you to run other 
programs, create and manage files, and use 
the peripheral devices (such as the console, 
printer, and disk drives) attached to your 
computer. 

TurboDOS is an "operating system", the tech¬ 
nical term for a program which supervises the 
operation of other programs. TurboDOS itself 
is not specialized for any particular appli¬ 
cation (such as word processing, accounting, 
or statistics). Instead, TurboDOS works 
together with whatever specialized applica¬ 
tion program you care to run, and takes care 
of whatever file and device management func¬ 
tions your particular application program 
requests. 

Now let's examine what makes TurboDOS dif¬ 
ferent from other operating systems. 


Why Use TurboDOS? Compared to other microcomputer operating 

systems, TurboDOS is distinguished by: 

. Networking Capability 
. CP/M and PC-DOS Compatibility 
. Superior Performance 
. Increased Disk Capacity 
. Enhanced Reliability 
. Print Spooling 

We'll begin with networking. 
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Networking Compared with other operating systems, Turbo¬ 

DOS perhaps is most distinguished by its 
ability to coordinate a "network" of inter¬ 
connected microcomputers. Generally, a sepa¬ 
rate microcomputer supports each user's video 
console. One or more additional microcompu¬ 
ters manage the disks, printers, and other 
shared devices of the system. 

Since this approach provides a microcomputer 
dedicated to each user, TurboDOS is able to 
support a large number of simultaneous users 
with excellent performance and minimal inter¬ 
action. You will discover this networking 
approach offers far better performance and 
reliability than does any system that relies 
on "time-sharing" one processor among many 
users. 


CP/M and PC-DOS TurboDOS lets you run any program designed to 

Compatibility operate with the popular CP/M and MP/M opera¬ 

ting systems from Digital Research. This 
means that you can choose from a vast library 
of available software packages: financial 
applications, word processors, spelling 
checkers, spreadsheets, language processors, 
and programming tools. 

TurboDOS runs virtually any CP/M program 
without modification, and accepts standard 
CP/M-format disks. TurboDOS is fully compa¬ 
tible with CP/M-80 2.2 and CP/M-86 1.1. In 
addition, TurboDOS provides compatibility 
with CP/M Plus, MP/M II, Concurrent CP/M-86, 
and MP/M-86 in file and record locks, queues, 
system date and time, and many other func¬ 
tions. 

8086 TurboDOS also includes an emulator for 
IBM Personal Computer DOS that allows many 
programs written for PC-DOS to be run under 
TurboDOS. 
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Performance Independent benchmark comparisons have shown 

that file-intensive applications perform much 
better with TurboDOS than with CP/M or MP/M. 
You'll benefit from this performance improve¬ 
ment with virtually any business application. 
File processing averages at least three times 
as fast, sometimes much more. The more users 
on your system, the greater the performance 
advantage becomes. 


Disk Capacity Business applications are often limited by 

the available disk capacity of your computer. 
TurboDOS lets you store 25% to 35% more data 
on each floppy disk, compared to most CP/M 
systems. This is achieved by using a more 
efficient format for storing data on disk. 
Standard-format CP/M disks are also accomo¬ 
dated by TurboDOS, of course, but they hold 
less data and run quite a bit slower. 

For bigger requirements, TurboDOS is designed 
to handle big hard disks and big files. CP/M 
has internal limitations which prevent it 
from supporting disks or files larger than 8 
megabytes. Disk drives larger than 8 mega¬ 
bytes have to be partitioned into segments, 
making them awkward to use. In contrast, 
TurboDOS supports disk drives to 1,000+ mega¬ 
bytes without partitioning, and supports 
files up to 134 megabytes. 


Reliability Integrity of data and graceful recovery from 

errors are critical to any serious data pro¬ 
cessing activity. TurboDOS offers vital 
improvements in these important areas. 

TurboDOS does read-after-write of all disk 
updates. In other words, whenever it writes 
information out to disk, it immediately reads 
it back to make sure it got recorded okay. 
(Most microcomputers don't do this!) 
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Whenever errors are detected, TurboDOS gives 
you meaningful diagnostic messages, and lets 
you chose from a variety of recovery options. 
In the event of a disk error, for example, 
you can choose one of these alternatives: 

. Retry the disk operation again 
. Ignore the error and continue processing 
. Abort the program 

In multi-user networking systems, TurboDOS 
incorporates an advanced failure detection 
and recovery facility that makes your system 
virtually crashproof. Even a malicious user 
cannot compromise the processing or files 
belonging to another user. 


The slowest component of your computer system 
is undoubtedly the printer. If your applica¬ 
tions involve much printing, you may find 
that the printer is the bottleneck that 
limits how much work you can get done on your 
system. To help solve this problem, TurboDOS 
includes an automatic "print spooling" faci¬ 
lity that lets you get on with the next 
processing task without having to wait for 
printing from the previous task to finish. 

Here's how it works. When your application 
program tries to send characters to the 
printer, TurboDOS intercepts them and saves 
them in a disk file instead. (This is called 
"spooling".) When the program is done, 
TurboDOS automatically starts printing the 
contents of the file. (This is called "de¬ 
spooling".) At the same time, it lets you go 
ahead and run your next program. 

In a multi-user system, several users may try 
to print at the same time. In this case, 
TurboDOS automatically queues the print files 
on a first-come first-served basis. 
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Hardware Needed 

At this point, let’s take a look at what kind 
of hardware TurboDOS can support, both multi¬ 
processor and single-processor. 

Multi-Processor 

Since today's microcomputers fit on a single 
small circuit board, an elaborate networking 
system with five or ten processors can be 
housed in a small desk-top enclosure. Alter¬ 
natively, the processors can be built into 
the user consoles and connected together with 
some sort of electrical cable. We call these 
"tightly-coupled" and "loosely-coupled" net¬ 
works, respectively. TurboDOS supports both. 

Single-Processor 

Single-user versions of TurboDOS are also 
available, both with and without print spool¬ 
ing capability. You'll find TurboDOS to be 
faster and more capable than other single- 
user operating systems. 


TurboDOS is not available in a "time-sharing" 
version (multiple users sharing a single 
processor). 

Memory Size 

The 8-bit processors should have 64K (kilo¬ 
bytes) of random access memory (RAM). Two 
banks of 64K (a total of 128K) is very desir¬ 
able for applications which require a lot of 
memory. 


The 16-bit processors should have at least 
128K of RAM, preferably more (up to the maxi¬ 
mum of one megabyte). The memory need not be 
contiguously addressed. 
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Getting Started 

To get TurboDOS started, it is necessary to 
read a copy of the operating system from your 
TurboDOS system disk into your computer's 
memory. This process is variously known as 
"cold start". 

Cold Start 

The exact cold-start procedure depends on the 
kind of hardware you are using. 


Usually, all you need to do is turn on the 
computer's power switch, or press the compu¬ 
ter's "reset" button (if the power is already 
on). If your TurboDOS system disk is a flop¬ 
py disk or other type of removable media, you 
need to load it into the disk drive. At this 
point, TurboDOS will load into memory automa¬ 
tically, and sign on. See "Installation 
Guide." 

Sign On 

On a single-user system (or a multi-user 
system with no log-on required), you will see 
the following display on your console as soon 
as TurboDOS is loaded: 


1 1 

1 TurboDOS 1.4x, Copyright 1984 etc. 1 

1 0A> 1 

1 1 


The "sign-on" message tells you which version 
of TurboDOS you are using. The "OAl" is 
the "command prompt" that tells you TurboDOS 
is ready to accept a command from your 
keyboard. It also tells you that user number 
zero and drive A are currently selected (more 
about this later). 

Multi-user systems usually require you to 
identify yourself before you may proceed. 
Let's see how this is done. 
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On most multi-user systems, you must "log on" 
by entering a valid user identification, 
password, and possibly other information: 


TurboDOS 1.4x, Copyright 1984 etc. 

System log on 

Enter user id: BARBARA 

Enter password: SHAZAM 

Enter activity: PAYROLL 

5A> 


In the example above (and throughout the 
remainder of this document), underlines are 
used to indicate the items you need to key 
in. The rest is displayed by TurboDOS. 
After you have typed each response, you have 
to press the RETURN (or ENTER) key on your 
keyboard before TurboDOS will process the 
item. 

The way TurboDOS validates user id's and 
passwords is described later on (see the 
details of the LOGON command). The date and 
time are not requested if the system clock 
was previously set. The activity description 
is requested only if a system log file has 
been set up. 

As soon as you get through the log-on proce¬ 
dure successfully, TurboDOS displays its 
"command prompt" to let you know it's ready 
to accept your first command. Remember that 
the "5 A)" prompt tells you that user number 5 
and drive A are currently selected. 

Next, we'll learn how to enter commands. 
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Entering Commands TurboDOS does only what you tell it to do. 

The way you tell it what to do is by entering 
commands on your console keyboard. 

Whenever you enter a command, you are actual¬ 
ly asking TurboDOS to load a particular pro¬ 
gram from disk into your computer's memory 
and run it. TurboDOS comes with more than 30 
standard commands (programs) that are de¬ 
scribed in detail in a later section of this 
guide. You can also enter commands to run 
application programs, or programs you have 
written yourself. 


Command Format A TurboDOS command always contains a command 

name which specifies the program to be run. 
The simplest commands consist only of the 
command name, followed by the RETURN (or 
ENTER) key. For example: 


I OA)DIR 


is a commonly-used command which displays a 
directory of the files on the currently- 
selected user number (zero) and disk drive 
(drive A). Remember that the command name 
"DIR" is actually the name of a program on 
disk. Don't forget the RETURN key at the end 
of each command. 

Frequently, the command name is followed by 
additional command information (drive letter, 
file name, option, etc.) to be passed to the 
command program. For example: 


I QA) DIR B: 


displays the directory for drive B. 
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Command Format Another example: 

(Continued) _ 


I OAl COPY A:ANYFILS B: 


is a command to copy a file named "ANYFILE" 
from drive A to drive B. "COPY" is the name 
of another command program. 


Multiple Commands You may enter several TurboDOS commands at 

one time. To do this, separate the commands 
with the character \ (backslant), and press 
RETURN after the last command. For example: 


I OA) DIR B_:_\DIR C:\DIR D: 

I_ 


is a string of three commands to display the 
directories of drives B, C and D in sequence. 

You can string as many commands together as 
you like, limited only by the size of the 
TurboDOS command buffer. Normally, the com¬ 
mand buffer is big enough for you to type a 
command string two lines long. 

When you enter a string of commands, TurboDOS 
executes each command in sequence, one after 
another. Each command but the first is 
displayed on your console as it is executed. 
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Correcting Errors As you type characters on the keyboard, • they 

appear on the screen of your console. An 
indicator called the "cursor” (usually a box 
or underline) shows you where the next char¬ 
acter will appear. 

If you make a typing mistake and you notice 
it before you press RETURN, you can correct 
it easily. Use the BACKSPACE or DEL key to 
delete the incorrect character (s) and move 
the cursor left. Then continue typing. 

If your keyboard doesn’t have a BACKSPACE or 
DEL key, you can accomplish the same thing by 
typing CTRL-H. To type CTRL-H, you hold down 
the CTRL key while typing the letter H. 

If you want to delete the entire line you've 
typed, you could keep typing BACKSPACE until 
it's all gone. An easier way is to type 
CTRL-X or CTRL-U (hold down CTRL while typing 
X or U), which accomplishes the same thing. 

If you accidentally misspell the name of a 
command, and hit RETURN before realizing your 
mistake, TurboDOS will tell you that it can't 
find a command with that name: 


OA) PIT B: 

DIT B: <— Command not found 
OA} 


and you can then retype the intended command. 
Likewise, if you enter a command TurboDOS 
can't figure out, it will let you know: 


OA) DIRB: 

DIRB: <— Invalid command 
OA) 
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Attention Requests You can suspend the execution of a program or 

command at any time by typing the "attention" 
character on your console keyboard. In most 
installations, this is either CTRL-S or 
CTRL-0. TurboDOSwill "beep" to acknowledge 
that it has received your attention request 
and suspended execution of your program. 

After an attention request, your program will 
remain suspended until you type one of the 
following attention responses: 

CTRL-~ (resume) simply restarts execution of 
your program at the point it was interrupted. 
You will find this attention/resume sequence 
useful to prevent displayed information from 
scrolling off the top of your console screen 
before you have time to read it. 

CTRL-C (abort) cancels program execution, and 
returns you to the TurboDOS command prompt. 

CTRL-P (echo-print) restarts program execu¬ 
tion and causes all subsequent console output 
also to be echoed on the printer. A second 
attention/echo sequence turns off echoing of 
console output to the printer. This feature 
is useful for getting hardcopy of your con¬ 
sole interactions with the system. 

CTRL-L (end-print) restarts program execution 
after signalling the end of the current print 
job. This is useful primarily when spooling, 
because it causes all accumulated print out¬ 
put to be immediately queued for printing. 
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This section has covered some of the basics 
you need to know about TurboDOS. You've 
learned what an operating system is, how 
TurboDOS compares with other microcomputer 
operating systems, and what kind of hardware 
it runs on. You've also learned how to load 
TurboDOS from a cold start, log on, enter 
commands and command strings, correct typing 
errors, and make attention requests. 

Our next topic is one of the most important 
in this guide: files and disks. 
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FILES AND DISKS In this section, you will learn more about 

how TurboDOS does its most important job: 
managing your files and disks. 


What is a File? A "file" is a collection of related infor¬ 
mation stored on disk. Files may contain 
data (numbers, text, formulas, pictures, and 
so on) or computer programs. 

You can think of a file on disk as being like 
a file folder in a file cabinet. When you 
store information in a file cabinet, you use 
file folders to group related information 
together. For instance, one folder might 
contain information about company employees 
(names, addresses, telephone numbers, and so 
forth). You might label this folder "Em¬ 
ployee Data" so you can find it later. 

Using your computer's disk instead of a file 
cabinet, you could set up a disk file con¬ 
taining the employee information. You might 
give this file the name EMPLOYEE.DAT. To 
keep track of your files, you have to give 
each one a name. 
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Identifying Files TurboDOS keeps track of your files by name. 

It maintains a directory of the files on each 
disk. Whenever you want to access a particu¬ 
lar file, you simply identify the one you 
want by name. 


Names and Types Within limits, you can give your files any 

names you want. Each file name can be up to 
eight characters long. Try to make up names 
that will remind you what each file contains: 



EMPLOYEE 

CONTRACT 

LOANCALC 



CUSTOMER 

TAXINFO 

STARTREK 



PAYROLL 

USRGUIDE 

PAYCHECK 



As you create more and more files, you will 
find they begin to fall into natural catego¬ 
ries (commands, BASIC programs, documents, 
data base files, and so forth). To help you 
group similar files together, you may add an 
optional extension (called a "file type") to 
your file names. The file type can be up to 
three characters long, and is always sepa¬ 
rated from the file name with a period: 


EMPLOYEE.DAT 
CUSTOMER.DAT 
PAYROLL.DAT 


CONTRACT.DOC 

TAXINFO.DOC 

USRGUIDE.DOC 


LOANCALC.BAS 
STARTREK.BAS 
PAYCHECK.BAS 


Certain file types have special meaning to 
TurboDOS. For example, Z80 commands (pro¬ 
grams) are kept in .COM files, and 8086 com¬ 
mands are kept in .CMD files. 

You can make up file names and file types 
using any desired combination of letters A-Z 
and digits 0-9. It's a good idea to stay 
away from punctuation marks. 
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To keep track of your files, TurboDOS main¬ 
tains a file directory on each disk. For 
each file, the directory contains the name, 
type and attributes of the file, what user it 
belongs to, how big it is, and where it is 
located on the disk. 

You can use the DIR command to display or 
print the file directory on any of your 
disks. For example: 


OAJniR 

THISDISK.LAB 15-Apr- 
22 FILES 0A:*.* 


CONTRACT.DOC 12K 
CUSTOMER.DAT 58K 
EMPLOYEE.DAT 28K 
etc. 

0 A) 


84 900K REMAINING 
324K DISPLAYED 

STARTREK.BAS 8K 
TAXINFO .DOC 2K 
USRGUIDE.DOC 96K 


The DIR command displays the files in alpha¬ 
betical order by name, and shows you the size 
of each one in kilobytes. (A kilobyte is 
1024 bytes.) It also shows you how much 
unused space remains on the disk, and other 
pertinent information. 
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Sometimes it's convenient to be able to refer 
to an entire group of files, such as "all 
payroll data files" or "all BASIC program 
files". For this purpose, TurboDOS provides 
two special characters ? and * that can be 
used in file names and types. 

You can use the ? in a file name or type as a 
"wild-card" to match any character in the 
corresponding position. You can use the * to 
indicate that all remaining character posi¬ 
tions of the file name or type are wild¬ 
cards . 

For example, the command: 


I 0A) DIR PAY?FILE.DAT 


might 

list the following 

files: 


1 

1 

PAY0FILE.DAT 

PAYAFILE.DAT 



PAY5FILE.DAT 

PAYXFILE.DAT 


1 

1 

PAY9FILE.DAT 

PAYZFILE.DAT 


while 

the command: 



1 

1 OAlDELETE *.BAS 


would delete all files of type .BAS from the 
disk. 

You'll find these wild-cards especially use¬ 
ful in connection with certain TurboDOS com¬ 
mands (such as COPY, DIR, DELETE, and RENAME) 
for processing a group of files without 
having to name each one individually. 
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Drive Selection Your computer system may be equipped with 

several disk drives (up to 16 of them). Each 
drive is assigned a letter A-P. In its com¬ 
mand prompt, TurboDOS reminds you which drive 
it is currently working on. 

When you refer to a file by name, TurboDOS 
normally looks for that file on the current 
drive. To access a file on a different 
drive, you have to enter a drive letter and a 
colon in front of the file name. 

For example, if you enter: 


I 0A> DELETE B:DOCUMENT.TXT 


TurboDOS will look for the file DOCUMENT.TXT 
on drive B, even though the current drive is 
drive A. 

You can also use a drive specification in 
front of a command keyword to indicate that 
you want TurboDOS to load the command from a 
particular drive: 


I QA> C:DELETE B:STARTREK.BAS I 


In this example, TurboDOS would look for 
DELETE.COM (or DELETE.CMD) on drive C, and 
for STARTREK.BAS on drive B. 
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Drive Selection 
(Continued) 

If you need to access many commands or files 
on the same drive, you might find it 
convenient to change the current drive so 
that you don't have to keep specifying the 
drive explicitly on every reference. To 
change the current drive, simply type the 
drive letter, a colon, and then RETURN: 


1 1 

1 0A>£j_ 1 

1 OB) 1 

1 1 


Notice that TurboDOS changes its command 
prompt to indicate the new current drive. 

Working with Files 

At this point, let's see how you can accom¬ 
plish some basic file operations using Turbo¬ 
DOS. These include creating, copying, renam¬ 
ing and deleting files. 


Creating Files TurboDOS does not have any special command to 

create a file. Most of the time, you create 
new files by running application programs. 
For example, to create a text file you would 
probably use a text editor or word processing 
program. You can also create files by making 
copies of other files. 

When a program creates a new file, the file 
starts out empty. As the program writes 
information to the file, TurboDOS automatic¬ 
ally allocates additional disk space. A file 
can grow as large as needed, limited only by 
the size of the disk. When a file is dele¬ 
ted, the disk space previously occupied by 
the file becomes available again. 
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To copy a file, use the COPY command: 


0 A} CQP. Y .. OKI 0 1 NAL , MS. . P ILPL I.C A X . B AS 
OA:ORIGINAL.BAS copied to 0A : DUPLICAT.BAS 
0A} 


If the second (destination) file name is not 
given in the COPY command, then the first 
(source) name is used: 


OA) COPY ORIGINAL.BAS C: 

0A:ORIGINAL.BAS copied to 0C:ORIGINAL.BAS 
0A> 


You can use wild-cards to copy a group of 
files with a single command: 


OA) COPY *.BAS C: 

Confirm individual files (y/n)? N 
OA:LOANCALC.BAS copied to 0C:LOANCALC.BAS 
OA:ORIGINAL.BAS copied to 0C:ORIGINAL.BAS 
OA:STARTREK.BAS copied to 0C:STARTREK.BAS 
0A> 


The COPY command is one of the most useful in 
TurboDOS. It has numerous features and op¬ 
tions that you'll want to study carefully 
when they're described later in this guide. 
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Renaming 

Files 

To change the name of a file, use 
command: 

the RENAME 



i 

1 OA)RENAME LOANCALC.BAS LC.BAS 


1 

1 



1 0A:LOANCALC.BAS renamed 0A:LC 

.BAS 

1 



1 0A) 

1 


1 



Using wild-cards, you can rename 

a qroup 

of 



files: 





1 

1 0A>RENAME STARTREK.* TREK.* 


1 

1 



i Confirm individual files (y/n)? 

N 

1 



1 0A:STARTREK.BAS renamed 0A:TREK 

.BAS 

1 



1 OA:STARTREK.COM renamed 0A:TREK 

.COM 

1 



1 0A:STARTREK.DOC renamed 0A:TREK 

.DOC 

1 



1 0A:STARTREK.REL renamed 0A:TREK 

.REL 

1 



1 OA} 


1 

1 






Deleting 

Files 

To erase a file from disk completely, use the 



DELETE command: 




0 A} nEhE I E-Q R l Ql N A L .,3 A £ 
0A:ORIGINAL.BAS deleted 
0A) 


Like COPY and RENAME, the DELETE command can 
be used with wild-cards to delete a group of 
files with one command. You should be 
especially careful when using DELETE, for 
obvious reasons. 
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It is ly for you to make 
backup copies of all your disks. Disks can 
be damaged and files can be erased as a 
result of human error or equipment failure. 
Such an event can be catastrophic if you have 
no backup copy of the lost disks or files. 
However, if you have been conscientious about 
making backup copies, you can recover your 
programs and data easily. 

Always make a working copy of any new soft¬ 
ware package you purchase, and save the ori¬ 
ginal. If the working copy is destroyed for 
any reason, you can always restore it from 
the original. 

Always make frequent backup copies of any 
programs and data files you are working on. 
As a general rule, you should make daily 
backup copies of all files you created or 
changed during the day. In many instances, 
it is prudent to make copies more frequently 
than once a day. 

There are two ways to make backup copies: 
using the COPYF command or the COPY command. 
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The COPYF command creates an exact duplicate 
of the contents of one floppy on another 
floppy of the same type: 


OA) COPYF A: B: 

PROG ID: COPYF Revision 2.0 

IMS INTERNATIONAL 

Copy Floppy Disk Utility 

Sector Size: 1024 
Density: D 

Number of sides: 2 
Number of cylinders: U_ 

Specified source drive: A 
Specified destination drive: 2 

Type <CR> to continue or <CTRL-C> to 
abort 
? 

Copying cylinder 76 
— Copy complete — 


The COPYF command can be used only to copy 
an entire disk to another disk of exactly the 
same kind and format. COPYF is the fastest 
method of copying a disk, because it copies 
everything in one operation. See page x-x. 
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The COPY command can also be used for making 
backup copies. You can use COPY to copy all 
files from one disk to another: 


OA)COPy A; 

B: ; N 




0A:ALPHA 

.COM 

copied 

to 

0B:ALPHA 

.COM 

0A:BETA 

.BAS 

copied 

• 

• 

to 

OB .-BETA 

.BAS 

0A:ZULU 

0A} 

.DAT 

• 

copied 

to 

OB:ZULU 

.DAT 


COPY is slower than COPYF because it copies 
one file at a time. COPY has some advan¬ 
tages, however. You can copy from one kind 
of disk to another -- from a hard disk to a 
floppy disk, for example. You can copy 
selected files or groups of files if you 
wish. In addition, the COPY command has an 
"archived" option for copying only those 
files that have been changed since last time 
you backed up. See page x-x. 
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Working with Disks So far, we've seen how TurboDOS works with 

files stored on disk. A single disk can hold 
dozens of files, sometimes hundreds of them. 
However, certain TurboDOS commands and faci¬ 
lities deal with the disk itself, rather than 
with the individual files stored on it. 


Kinds of Disks A disk is a rotating magnetic medium used by 

a computer system to store programs and data. 
Information is recorded on disk magnetically, 
much as voice or music is recorded on audio 
tape. The term "disk" applies to several 
kinds of storage media: floppy disks, remov¬ 
able cartridge disks, and fixed hard disks. 

Floppy disks (also called "diskettes") are 
inexpensive, and often the only kind of stor¬ 
age available on small microcomputer systems. 
They are removable disks which use a flexible 
magnetic medium that spins inside a cardboard 
jacket. Floppy disks come in 8-inch and 
5.25-inch diameter sizes (even smaller ones 
are being developed). They may be recorded 
on one or both sides, and commonly have capa¬ 
cities of 150K to 1,500K (kilobytes). 

Cartridge disks are also removable, but they 
use a rigid ("hard") medium that allows much 
more data to be stored on each disk. They 
are considerably more expensive than flop¬ 
pies, so their use on microcomputer systems 
has been somewhat limited. Cartridge disks 
come in 14-inch, 8-inch, and 5.25-inch diame¬ 
ters, and typically hold 2 to 20 megabytes (a 
megabyte is 1024K, more than a million 
bytes). 
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Kinds of Disks Fixed hard disks (sometimes called "Winches- 
(Continued) ter" disks) use one or several rigid magnetic 

platters sealed inside an airtight container. 
They provide a reliable and economical means 
of storing a lot of information (typically 5 
to 50 megabytes), and are rapidly becoming 
popular in medium-to-large microcomputer sys¬ 
tems. The disadvantage of such disks is that 
they are non-removable. Consequently, some 
other kind of removable medium (floppy disk, 
cartridge disk, or tape) is almost always 
required for backup and archive purposes. 


Disk Formats Information is recorded on disks along con¬ 

centric circular "tracks", somewhat like the 
grooves on a phonograph record. Each track 
is further subdivided into fixed-length "sec¬ 
tors". The "format" of a disk refers to how 
many tracks are recorded on the disk (on 
either one or both sides), how many sectors 
are recorded on each track, and how many 
bytes are recorded in each sector. 

For some kinds of disks ("hard-sectored"), 
the format is fixed by the hardware itself. 
For others ("soft-sectored"), the format must 
be pre-recorded onto the disk by means of the 
TurboDOS COPYF command before the disk can 
be used. Most floppy disks and many hard 
disks are soft-sectored. 

For maximum capacity and performance, floppy 
disks used with TurboDOS are generally for¬ 
matted with large sector sizes (typically 512 
or 1024 bytes). However, TurboDOS can also 
accomodate standard CP/M formats. TurboDOS 
determines automatically whether a floppy 
disk is recorded in CP/M or TurboDOS format. 
TurboDOS-format diskettes hold 25% to 35% 
more data, and run very much faster. The 
COPYF command can initialize a disk in 
either CP/M or TurboDOS format. 
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Disk Formats You must use COPYF to format every disk 

(Continued) before it can be used by TurboDOS for the 

first time: 



PROG ID: FMTF Revision 2.0 

IMS INTERNATIONAL 
Floppy Disk Format Utility 

Enter "T" or "C" for TurboDOS or CP/M sector size 
?I 

Enter "S" or "D" for single-density or double-density 
?D 

Enter "1" or "2" for single-sided or double-sided 
?2 

Selected sector size type: T 
Selected density: D 
Selected number of sides: 2 

FMTF will format diskette in floppy drive A 
Type <CR> to continue or <CTRL-C> to abort 


Formatting Cylinder 76 
Verifying Cylinder 76 
— Format Complete — 
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It is also a good idea to use the ERASEDIR 
command to create an empty directory on the 
newly-formatted disk, and to use the LABEL 
command to give a name to the disk: 


OA) ERASEDIR- B: 

Hashed directory desired (Y/N)? N 

OK to erase directory on drive B? Y 

Erasing directory 

Directory erased, non-hashed 

0A) LABEL B:PAYROLL.DAT 

Disk label written 

OA) 


You must use this procedure whenever a new 
disk is placed into service for the first 
time. You may also use this procedure when¬ 
ever you want to erase everything from a used 
disk and start out fresh. Be careful — once 
you use FMTF or ERASEDIR, any files pre¬ 
viously stored on the disk are lost forever, 
ion You don't really need to know how disks are 
organized in order to use TurboDOS, but it 
can be helpful in understanding certain disk- 
oriented commands. Each disk is organized by 
TurboDOS into five areas illustrated below: 


I File Storage 


File Storage 


Directory 


Allocation Map 


Volume Label 


Reserved Tracks 
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The "reserved tracks" are required by certain 
hardware configurations to support system 
start-up, but not otherwise used by TurboDOS. 
If your equipment requires reserved tracks, 
you can use the BOOT command to write infor¬ 
mation on them. 

The "volume label" contains the name you have 
assigned to the disk. The LABEL command lets 
you give a name to each of your disks. 

The "allocation map" is the area in which 
TurboDOS keeps track of which portions of the 
disk storage space are occupied with informa¬ 
tion, and which portions are free. You can 
use the FIXMAP command to reconstitute this 
critical information whenever you suspect it 
might have become corrupted. It is a good 
idea to use FIXMAP after any "crash" or other 
unexplained system malfunction. 
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Disk Organization The "directory" is a table of contents which 
(Continued) lists all files stored on the disk. For each 

file, there is a directory entry containing 
the file's name, type, attributes, ownership, 
size, and location on the disk. The DIR 
command lets you display or print the direc¬ 
tory. The FIXDIR command lets you reorganize 
the directory when frequent additions and 
deletions of files cause directory access to 
become less efficient. 

All the rest of the disk (most of it) is 
available to hold your files. You can obtain 
details about the format and organization of 
any disk by using the DRIVE command: 


QA> DRIVE C: 

Disk drive characteristics, drive C 


Maximum data capacity : 1224K 

Allocation block size : 2048 

Number of directory entries: 256 
Physical sector size : 1024 

Physical sectors per track : 16 

Physical tracks per disk : 77 

Number of reserved tracks : 0 

Media is removable 
0A) 


Unlike TurboDOS, CP/M does not maintain a 
volume label or allocation map on the disks 
it creates. When a CP/M disk is first ac¬ 
cessed by TurboDOS, the first few CP/M direc¬ 
tory entries are automatically relocated to 
the end of the directory in order to make 
room for the label and map. When a TurboDOS 
disk is accessed by CP/M, the label and map 
appear to be ordinary deleted directory en¬ 
tries. The result is that disks can be moved 
freely between CP/M and TurboDOS without 
concern about the differences in organiza¬ 
tion. 
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Directory Formats In addition to CP/M-compatible "linear" di¬ 
rectories, TurboDOS also supports an optional 
"hashed" directory format that makes look-up 
in large directories much faster. 

The standard linear directory format is 
media-compatible with CP/M, and is searched 
sequentially. Because of this, look-up speed 
gets slower as the directory gets bigger. 
For hard disks with big directories, look-up 
time can get painfully slow. 

The optional hashed directory format uses a 
"hashing algorithm", a sophisticated tech- 
. nique for making look-up on large directories 
much faster. A hashed directory may be used 
on any disk, but is especially suited for use 
on hard disks with big directories. Hashed 
directories are not media-compatible with 
CP/M (but CP/M applications still run fine). 


To initialize a disk to use this 
hashed directory format, use the 
command. Alternatively, to change 
ing directory from linear to hashed 
versa), use the FIXDIR command: 


optional 
ERASEDIR 
an exist- 
(or vice- 


0 A) FX X DJLR., 

Hashed directory desired (Y/N)? Y 

OK to reorganize directory on drive C? Y 

Reorganizing directory-DO NOT INTERRUPT 

Directory reorganized, hashed 

0A) 


When you display a hashed directory using 
DIR, the symbol "(H)" appears in the heading. 

Whether the directory is linear or hashed, 
searches involving "wild cards" have to be 
done linearly. Such wild-card searches are 
typically slower if the directory is hashed. 
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Changing Disks Multi-user systems require special care when 

changing floppy disks (or other removable 
media). First, you should check to make sure 
that no other user is using the disk you want 
to change. Then use the CHANGE command to 
let TurboDOS know you want to change disks: 


OA) CHANGE 

Enter drive(s) to be changed: BCD 

Change drive(s) BCD 

Enter <CR> when change complete 


Wait until the CHANGE command tells you it's 
okay to change the disks (as above). Then 
remove and replace disks as required. Final- 
ly, press RETURN to advise you are done with 
the change. Remember, never remove a disk 
without first entering a CHANGE command. 

In a single-user system, it is safe to change 
disks whenever the system pauses for console 
input. You don't have to use CHANGE. 


Disk Errors If you hear a "beep" and see a diagnostic 

message on your console such as: 


Read Error, Drive A, Track 0, Sector 2 
[Retry, Ignore, Abort] 

Write Error, Drive B, Track 5, Sector 16 
[Retry, Ignore, Abort] 


it means that TurboDOS could not read or 
write the specified disk sector even after a 
number of retries. When you see such a mes¬ 
sage, you must choose one of three recovery 
options (Retry, Ignore, Abort) by keying the 
letter R, I, or A. 
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If you key R (retry), TurboDOS will try the 
read or write operation several more times. 
If it is still unsuccessful, you will get 
another message. 

If you key I (ignore), processing will con¬ 
tinue as if the error had not occurred. This 
option is not recommended in most situations 
because it causes processing of invalid data 
and may lead to other errors. 

If you key A (abort), TurboDOS terminates the 
program you were running when the error oc¬ 
curred. 

If you hear a "beep" and see this message on 
your console: 


I Not Ready Error, Drive C [Retry, Abort] 


it means TurboDOS could not access the selec¬ 
ted drive for one of the following reasons: 

. there's no such drive on your system 
. the drive isn't ready to operate 
. the drive's door was left open 
. no disk is mounted in the drive 
. the disk hasn't been formatted 
. the disk format is unrecognizable 
. in the case of certain commands (COPYF, 
BOOT, FMTF and VERIFY), the drive is 
not local to the processor in which you 
are executing the command 

Again, you must select the desired recovery 
option by keying R or A. 
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You know already that TurboDOS maintains a 
directory on each disk which lists all files 
on the disk. Within the directory, TurboDOS 
provides up to 32 separate file libraries 
corresponding to user numbers 0-31. These 
libraries are especially useful in a multi¬ 
user system, since they allow you to maintain 
separation between files belonging to dif¬ 
ferent users or applications. 

When you first log on to a multi-user Turbo¬ 
DOS system, the system assigns you to one of 
these user numbers according to the user id 
that you specify. You can see which user 
number you have been assigned by looking at 
the command prompt. For example: 


I 

I 5B> 



tells you that your user number is five. 
Generally, user 0 is reserved for global 
files (explained shortly) and user 31 is 
reserved for log-on security, leaving 1-30 
for general use. 

Ordinarily, you are confined to your assigned 
user number from log on until log off. Most 
file operations (creating, renaming, delet¬ 
ing, searching, etc.) are confined to the 
library which corresponds to your user num¬ 
ber. For example, if you enter the command: 


I 5B>DI£ 


you will get a directory of only those files 
in the user 5 library on drive B. 
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The log-on mechanism of TurboDOS permits 
certain user id's to be "privileged", allow¬ 
ing those users to access various protected 
facilities of TurboDOS. A privileged user 
may access any user number. User numbers are 
selected just like drive letters. To change 
the current user number, for example: 


5B)12: 
12B) 20A: 
20A) 


To display the directory for a particular 
user number and drive: 


I 0A> DIR 12B: 


Or to copy files from one user number and 
drive to another: 


I OA) C 0 P . Y- J.2Bj * ,BA£-_ 2QA - ; I 

I_I 

Remember, ordinary (non-privileged) users are 
not allowed to access other user numbers: 


5B)12: 

12: <— Non-privileged user 
5B)p_I R _. X 2 ; 

Non-privileged user 
5B) 


In most single-user TurboDOS systems, log on 
is not required. You are logged on automa¬ 
tically to user zero and privileged. From 
there, you can access any user number. 
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File Attributes File attributes may be used to control how a 

file can be accessed. TurboDOS defines four 
such attributes: Read-only, Global, Archived, 
and FIFO. Each of these attributes is ex¬ 
plained in detail below. 

You can set and clear file attributes with 
the SET command. For example: 


0A) SET *.COM :N +RG -A 


0A:COPY 

.COM 

set 

to 

RG 

0A:DELETE 

.COM 

set 

to 

RG 

0A:RENAME 

.COM 

set 

to 

RG 


0 A) 


sets all .COM files to Read-only, Global, and 
not Archived. The SHOW command lets you see 
the settings of file attributes. 


Read-Only File TurboDOS lets you protect important files and 

disks against accidental destruction by mark¬ 
ing them with the "read-only" attribute. 
Read-only files can't be written, deleted or 
renamed. (To delete, rename or modify a 
read-only file intentionally, you must first 
clear the read-only attribute.) 


Global File If you save a file under user 0 and mark it 

with the "global" attribute, you can access 
that file from any user number. This pro¬ 
vides a convenient way to make selected files 
available to all users. For example, you'd 
probably want to do this with most TurboDOS 
commands and other common programs. (Other¬ 
wise, you'd have to put duplicate copies 
under each user number, wasting disk space.) 
Remember, global files must be in the user 0 
library -- otherwise, the global attribute 
has no effect. 
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Archived File The "archived" attribute works together with 

the COPY command to provide a convenient 
mechanism for doing incremental file backup. 
This attribute is set automatically whenever 
a file is archived by the COPY command, and 
cleared automatically whenever a file is 
written or renamed. When the COPY command is 
used for archiving, it automatically skips 
over files which have the archived attribute 
set. As a result, only files that have been 
written or renamed since the last archiving 
cycle are copied. 

This incremental backup facility is particu¬ 
larly useful for backing up fixed disks, 
where copying all files would be too slow. 


FIFO File The "FIFO" attribute causes a file to be 

accessed by TurboDOS using a special first- 
in-first-out access method. FIFO files are 
especially convenient for inter-process and 
inter-user communications, and are described 
in more detail in the Programmer 1 s Guide . 


Read-Only Drive TurboDOS allows drives to be marked read-only 

much in the same fashion as files. Another 
variation of the SET command is used: 


0A> SET C: :+R 

Drive C set to read-only 

QA> SET C: :-R 

Drive C set to read/write 

0A} 


Setting a drive read-only prevents TurboDOS 
from making any attempt to write to that 
drive. This is a good way to protect impor¬ 
tant disks against accidental destruction 
while making backup copies, for instance. 
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Whenever you ask to access a file, TurboDOS 
first searches the library corresponding to 
the current (or specified) user number. If 
the file is not found, TurboDOS then searches 
the user 0 library to see if the file is 
there and is marked as global. For example, 
if you entered this command: 


I 5B} TYPE ,, T AXJN- FQ . W£ 


TurboDOS would first search the user 5 libra¬ 
ry on drive C. If it can't find TAXINFO.DOC 
there, then it searches the user 0 directory 
on drive C, looking for TAXINFO.DOC marked 
with the global attribute. If both searches 
are unsuccessful, the TYPE command displays 
the message "File Not Found". 

The search procedure for command files (pro¬ 
grams) is similar, but with one added compli¬ 
cation. TurboDOS can be configured with a 
specified "search drive" which is searched 
automatically if you don't specify an expli¬ 
cit drive letter, and if the normal search of 
the current drive fails. Using the previous 
example, if your system is configured with 
drive A as the "search drive", TurboDOS would 
search for the command file TYPE.COM (or 
TYPE.CMD) in the following sequence: 

. drive B, user 5 

. drive B, user 0 (global) 

. drive A, user 5 

. drive A, user 0 (global) 

before giving up and displaying the message 
"Command Not Found". 
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File Sharing In a multi-user TurboDOS system, it is quite 

possible that two or more users may want to 
access the same file at the same time. This 
can happen if the users are logged on to the 
same user number, or if they are accessing 
the same global file. TurboDOS has various 
facilities to regulate such file sharing. 


File Locks As a general rule, TurboDOS allows any number 

of users to read a file at the same time, but 
only one user may write the file. (This is 
called the "permissive" rule.) If a second 
user tries to write the file before the first 
user is finished, the second user will re¬ 
ceive an error message. The exact message 
depends upon the application programs being 
run, but is usually something like "cannot 
write file" or "disk full". 

Alternatively, it is possible to set up Tur¬ 
boDOS so that only one user can access any 
file at a time. (This is called the "exclu¬ 
sive" rule.) If your system is set up in 
this fashion, and if a second user tries to 
access the file before the first is finished, 
the second user will receive an error mes¬ 
sage, usually something like "cannot open 
file" or "file not found". 


Record Locks TurboDOS also has record locking facilities 

that make it possible for several users to 
access and update common files at the same 
time. Record locking is not automatic. Pro¬ 
grams must make explicit requests for Turbo¬ 
DOS to open files in a special "shared" mode, 
and to lock and unlock records. 

Remember, simultaneous updating requires ap¬ 
plication programs specially-written for a 
multi-user environment. Ordinary single-user 
applications will not do. 
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This section has explained how TurboDOS mana¬ 
ges your files on disk. You've learned what 
files are, how they are identified by name, 
and how you can create, copy, rename and 
delete them. You know how TurboDOS disks are 
organized, and the proper procedures for 
formatting disks, changing disks, and recov¬ 
ering from disk errors. You understand the 
importance of making frequent backup copies 
of your important programs and data files. 
And you know about user numbers, file attri¬ 
butes, and file sharing. Congratulations! 

Next, we look at how TurboDOS handles print¬ 
ing and print spooling. 
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PRINTING 

This section teaches you all about printing 
under TurboDOS, including how to use its 
print spooling capabilities to best advan¬ 
tage. The printing facilies of TurboDOS are 
rather elaborate, so there's quite a bit to 
learn. 

Printing Methods 

We'll start by describing the various print¬ 
ing methods supported by TurboDOS. Later, 
we'll go into detail about the commands used 
to control printing. 


Your' system may be equipped with several 
printers (up to 16 of them), all of which may 
be in-use simultaneously. Each printer is 
assigned a letter A-P (just as in the case of 
disk drives). You can control which printer 
you want to use at any given time. In a 
multi-user system, each user can control his 
print routing independently. 


There are two fundamentally different methods 
of printing in TurboDOS: direct and spooled. 


Direct Printing Print output may be routed directly to any 

specified printer on a character-by-character 
basis. This is the simplest method of print¬ 
ing in TurboDOS, and the only method suppor¬ 
ted by CP/M. Direct printing is useful for 
very long print jobs (e.g., overnight), and 
for certain special situations such as 
single-sheet printing. 

Direct printing has some drawbacks, however. 
For one thing, when you use direct printing, 
your console is tied up until the print job 
has finished. Printers are generally the 
slowest components of any computer system, 
and you will find they are often a bottleneck 
limiting how much work you can get done. 


3-1 






PRINTING 

Printing Methods 
(Continued) 


Copyright 1984 by Software 2000, Inc. 
All rights reserved. 


Direct Printing Another drawback of direct printing is that 

(Continued) it is very awkward to use in a multi-user 

environment. If two users attempt to print 
directly to the same printer at the same 
time, the result is a merged printout that is 
not likely to be of much use to either user. 
Thus, direct printing requires that users 
carefully coordinate among themselves to 
avoid such conflicts. 

You can eliminate both of these problems by 
using spooled printing. 

Spooled Printing When you select spooled printing, TurboDOS 

intercepts the print output from your program 
and saves it in a print file on disk. This 
process is called "spooling", and the result¬ 
ing print file is sometimes called a "spool 
file". 

When the print job is done, TurboDOS automa¬ 
tically starts printing the contents of the 
print file. This process is called "de¬ 
spooling", and takes place in the background 
independent of your console. You can go 
ahead and run your next program without wait¬ 
ing for the printing to finish. When the 
printing is finished, the print file is dele¬ 
ted automatically. 

In a multi-user environment, several users 
may be generating spooled print output at the 
same time without any interference. As their 
jobs finish, TurboDOS automatically queues 
the print files for de-spooling on a first- 
come first-served basis. 
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Print Jobs When a program generates its first character 

of print output, a new "print job" begins. 
If spooled printing is in effect, TurboDOS 
creates a new print file automatically at 
this point. Subsequent print output is 
spooled to this print file until the print 
job ends, whereupon TurboDOS closes the print 
file and queues it for de-spooling. 

In most cases, the print job ends automa¬ 
tically at the conclusion of the program. 
However, the print job may also be ended by 
an end-print attention request from the con¬ 
sole, by an explicit end-print request from 
the program, or by the presence of a reserved 
end-of-print character in the print output 
stream (if one is defined for your system). 


Using Print Queues TurboDOS supports up to 16 print queues, 

identified by the letters A-P. A print queue 
is simply a list of print jobs awaiting de- 
spooled printing. You can assign any printer 
on your system to de-spool from any print 
queue. Jobs are always printed from a parti¬ 
cular queue on a first-come first-served 
basis. 

The simplest way to use these queues is to 
assign each printer to a different queue -- 
for example, printer A to queue A, printer B 
to queue B, and so on. However, queues may 
be used in more imaginative ways. 
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Using Print Queues Even if your computer has only one printer, 
(Continued) you may want to make use of several print 

queues to group together print jobs with 
similar forms requirements and/or priorities. 
For example, you could use queue A for jobs 
requiring wide paper, queue B for jobs to be 
printed on narrow paper, queue C for jobs to 
be printed on pre-printed invoice forms, 
queue D for computer-printed checks, and so 
forth. Whenever the printer is done printing 
all jobs from one queue, you can re-assign 
the printer to a different queue after chang¬ 
ing to the appropriate kind of paper. 

If your system has multiple printers, you can 
assign two or more printers to the same print 
queue. In this case, TurboDOS performs auto¬ 
matic load sharing by dividing up the work¬ 
load among the printers. This technique is 
appropriate if you don't care which printer 
is used to print which job. 


Manual Spooling In addition to the automatic print spooling 

already described, TurboDOS supports a manual 
spooling mode in which print output is 
spooled to a print file but not automatically 
queued for printing when the print job ends. 
When you use this mode, the print file re¬ 
mains on disk indefinitely, until you either 
delete it or manually queue it for printing. 
TurboDOS provides a special command for manu¬ 
ally queuing such files (or any text file, 
for that matter). 

The manual spooling mode is useful in various 
situations: for example, when you're not sure 
whether or not you want to print a job; when 
you need to print several copies of the same 
job; or when you want to use the print output 
of one program as the input to some other 
program. 
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De-spooling is an automatic background acti¬ 
vity which generally requires no operator 
attention. However, TurboDOS lets you exer¬ 
cise control over de-spooling in various ways 
when necessary. 

You can assign any printer to de-spool from 
any print queue, or place any printer in an 
"off-line" status (to allow you to change 
paper or ribbons, for example). You can stop 
and restart printing on any printer, restart 
any print job from the beginning, or termi¬ 
nate any print job altogether. These control 
functions may be exercised from any user 
console. 

Now that we've reviewed the printing capabi¬ 
lities of TurboDOS, let's look at the com¬ 
mands for controlling print routing, queuing, 
and de-spooling. They are PRINT, QUEUE, and 
PRINTER. 
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Routing Control The PRINT command controls the routing of 

print output. In a multi-user system, each 
user may control his own print routing inde¬ 
pendently. 


Direct Printing To select the direct printing mode, you need 

only specify which printer (A-P) you wish to 
use: 


OAIPI U NT- P R I NT E RS 
Printing is to PRINTER B 
0A) 


When using direct printing in a multi-user 
system, make sure no one else uses that 
printer until your printing is finished. 


Automatic Spooling To select the automatic spooling mode, you 

must specify on which queue (A-P) you want 
your print job placed. You may also specify 
the disk drive onto which you want the print 
file to be written: 


QA> PRINT DRIVE=C OUEUE=A 
Printing is to SPOOLER on DRIVE C 
to QUEUE A 
0A> PRINT OUEUE=B 

Printing is to SPOOLER on DRIVE C 
to QUEUE B 

0A> 


If you don't specify the spool drive, it will 
remain the same as before. 
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Manual Spooling To select the manual spooling mode (in which 

the print file is not automatically queued), 
the keyword FILE is used: 


0A)PRIN T . F ILE 

Printing is to SPOOLER on DRIVE C 
0A) PRINT FILE DRIVE=A 
Printing is to SPOOLER on DRIVE A 
0 A) 


Again, you need to specify the spool drive 
only if you want to change it. 


Other Options You can direct print output to your console 

with the following command: 


0A) PRINT.CONSOLE 

Printing is to CONSOLE 
0A) 


You can cause print output to be discarded 
altogether by using this command: 


OAlPRINT-Pf E LJNE 
Printing is to OFFLINE 
0A) 


Finally, a PRINT command with no parameters 
displays your current print routing: 


OA) PRINT 

Printing is to SPOOLER on DRIVE A 
to QUEUE A 

OA) 
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Queuing Manually The QUEUE command lets you manually queue 

print files (or any text file) for de-spooled 
printing: 


OA) QUEUE TEXTFILE.PRN 
0A:TEXTFILE.PRN queued 
0A> 


The QUEUE command lets you specify which 
queue you want to use, but if you don't (as 
in the example above) the current queue is 
used (as set by the last PRINT command). You 
can specify that you want the file to be 
deleted after it is printed. You can even 
use wild-cards in the file name to queue a 
group of files with a single command. For 
details on all these variations, refer to the 
QUEUE command description later in this docu¬ 
ment. 
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De-Spool Control The PRINTER command lets you control de- 

spooled printing on any printer in your sys¬ 
tem. This command may be used by any user 
from any console. 


Queue Assignment To assign a printer (A-P) to de-spool from a 

particular print queue (A-P): 


0A)PRIN T ER A. QUEU E=C 

PRINTER A assigned to QUEUE C 

0A) 


If the printer is currently printing, the new 
assignment takes effect at the end of the 
current print job. 


To display the current de-spool assignment of 
a particular printer: 


0A}£RINXER_A 

PRINTER A assigned to QUEUE C 
OA) 


To take a specified printer off-line at the 
end of the current print job: 


0A> PRINTER A OFFLINE 

PRINTER A assigned to OFFLINE 

OA} 


The purpose of taking a printer off-line is 
to prevent subsequent de-spooling to that 
printer. This is useful when you want to 
change paper of ribbons, or when you want to 
reserve the printer for direct printing. 
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Print Job Control To temporarily suspend de-spooling to a spe¬ 
cified printer (to correct a paper jam, for 
example): 


0A> PRINTER, A. STOP 

PRINTER A assigned to QUEUE C (Stopped) 
0A} 


To resume de-spooling from the point it was 
stopped: 


0A) P RINT E R-A JGQ 

PRINTER A assigned to QUEUE C 

0A> 


To stop de-spooling to a specified printer 
and restart the current print job from the 
beginning when de-spooling is resumed: 


0A> PRINTER A BEGIN 

PRINTER A assigned to QUEUE C (Stopped) 
0A) 


To terminate the current print job on a spe^ 
cified printer, and continue with the next 
queued job: 


0A> P RI NTE R.. A T E RM I NATE 
PRINTER A assigned to QUEUE C 
0A} 


The terminated print file is not deleted from 
disk, so the job may be manually re-queued 
with the QUEUE command. 
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Errors If you hear a "beep" and see the following 

diagnostic message on your console: 


I Spooler Error (Ignore, Abort) 


it means that the disk to which you were 
spooling has run out of space in the middle 
of your print job. TurboDOS has closed your 
print file (prematurely), but has not queued 
it for de-spooling. 

When you see this message, you must choose 
one of the two recovery options (Ignore or 
Abort) by keying the letter I or A. 

If you key I (ignore), your print routing is 
set to "off-line", and your program will 
continue with any further print output dis¬ 
carded. 

If you key A (abort), your program will be 
terminated. 


In this section, you've learned all about 
printing and print spooling in all its many 
variations. 

Next, you will find out more about how Turbo¬ 
DOS processes commands. 
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PROCESSING This section teaches you about the various 

processing methods available under TurboDOS, 
including interactive and batch processing in 
both single and multi-processor environments. 


Command Processing A TurboDOS command always identifies a pro¬ 
gram file residing on disk, and causes that 
program to be loaded into memory and execu¬ 
ted. TurboDOS has no "built-in" commands. 

TurboDOS comes with more than 30 standard 
command programs (described in detail in the 
next section). You can expand the vocabulary 
of commands by adding programs you purchase 
or programs you write yourself. Program 
files are distinguished by their special 
type: .COM for Z80 programs, .CMD for 8086 
programs. 


Simple Commands Every TurboDOS command consists of the file 

name of the program to be executed, possibly 
followed by an optional "command tail". 

The program name may have an explicit file 
type, but usually doesn't (TurboDOS assumes 
.COM or .CMD as appropriate). It may also 
have an explicit drive specification (like 
"B:") if the program is not on the current 
drive. 

The format of the command tail is determined 
by the particular command (program) involved. 
TurboDOS simply passes the command tail (if 
any) to the program. The command tail cannot 
exceed 126 characters in length. 
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s TurboDOS also accepts strings of commands 
separated by the character \ (backslant). 
The length of a command string is limited 
only by the size of the TurboDOS command 
buffer (normally enough for a command string 
two lines long). 

TurboDOS executes each command of the command 
string in sequence: 


0A} DIR B:\DIR C:\DIR D: 
...(drive B directory)... 
0A)DIR C: 

...(drive C directory)... 
0A) DIR D: 

...(drive D directory)... 
0A) 


and re-displays each command but the first as 
it is executed (illustrated above). This 
command re-display is supressed if the com¬ 
mand string begins with a backslant: 

I ~~~ I 

I 0A}.\ PI K. B; . \PI R- C:\PI R- P; I 

I ...(drive B directory)... I 

I ...(drive C directory)... I 

I I 

I ...(drive D directory)... I 

I I 

I 0A> I 
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Batch Processing Sometimes you will find yourself performing 

certain command sequences quite frequently. 
It's convenient to save such sequences on 
disk, especially if they're long or complex. 
You can perform such pre-defined command 
sequences automatically with the DO command. 


Simple Do-Files Do-files are text files (usually type .DO). 

You can prepare do-files with your favorite 
text editing or word processing program. For 
example: 


OA) TYPE RUNPROG.DO 

BASCOM PROG.REL,PROG.PRN=PROG.BAS/S/C 

TYPE PROG.PRN ;L 

DELETE PROG.PRN 

L80 PROG.REL/M/E,PROG.COM/N 

DELETE PROG.REL 

PROG 

OA) 


To execute the do-file, use the DO command: 


OA) DO. RUNPROG 

OAlBASCOM PROG.REL,PROG.PRN=PROG.BAS/S/C 
...(compilation)... 

OA)TYPE PROG.PRN ;L 
...(listing to printer)... 

0A>DELETE PROG.PRN 
OAjPROG .PRN deleted 

0A>L80 PROG.REL/M/E,PROG.COM/N 
...(link map)... 

0A)DELETE PROG.REL 
OA:PROG .REL deleted 

OA)PROG 

...(execution of PROG program)... 

OA) 
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Simple Do-Files Certain commands (such as COPY, RENAME and 
(Continued) DELETE) may expect interactive input from the 

console keyboard. If such a command is exe¬ 
cuted from within a do-file, then its console 
input comes from the do-file rather than the 
keyboard. For example: 


OA)TYPE. PELPR QG.DQ 

DELETE 

PROG.PRN 

PROG.REL 

PROG.COM 

0A) DO DELPROG 

OA)DELETE 

* PROG.PRN 

OA:PROG.PRN deleted 

* PROG.REL 

OA:PROG.REL deleted 

* PROG.COM 

OA:PROG.COM deleted 

* 

OA} 


Most programs which expect keyboard input may 
be run from within a do-file in this fashion. 
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You can prepare a do-file with variable para¬ 
meters which can have different values each 
time you execute it. When you prepare the 
do-file, mark the position of parameters in 
the do-file as {!), {2}, and so on: 


0 A} _TYPE RUNBAS. DO 

BASCOM {1}.REL,{1}.PRN={1).BAS/S/C 
TYPE {1}.PRN ;L 
DELETE {1}.PRN 
L80 {1}.REL{2}/E,{1}.COM/N 
DELETE {1>.REL 
{ 1 } 

0A} 


When you execute the do file, specify the 
argument values in the command tail of the DO 
command. The first argument replaces each 
occurrence of Q) in the do-file, the second 
argument replaces each {2}, and so forth: 


0A) DO RUNBAS PROG /M 

0A)BASCOM PROG.REL,PROG.PRN=PROG.BAS/ S/C 
... (compilation) ... 

0A}TYPE PROG.PRN ;L 
...(listing to printer)... 

0A>DELETE PROG.PRN 
OArPROG .PRN deleted 

0A}L80 PROG.REL/M/E,PROG.COM/N 
...(link map)... 

0A)DELETE PROG.REL 
OArPROG .REL deleted 

0A)PROG 

...(execution of PROG program)... 
OAlDELETE RUNBAS.DO$ 

0A:RUNBAS .DO$ deleted 
0A) 
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Do-File Parameters When arguments are present, the DO command 
(Continued) makes a temporary copy of your do-file in 

which arguments are substituted for parame¬ 
ters as required. The temporary file is 
executed, and then deleted when execution is 
done. 

Note: if the do-file contains parameter marks 
(such as Cl}), then the DO command m ust have 
at least one argument to activate the substi¬ 
tution process. A null argument such as "" 
or 1 ' will suffice. 


Nested Do-Files Do-files may contain embedded DO commands: 


0A) TYPE RUN.DO 
DO COMPILE {1} 

DO LINK {1} (2> 

U) 

0A> type compile.do 

BASCOM (1>.REL,(1>.PRN={1}.BAS/S/C 

TYPE {1}.PRN ;L 

DELETE (l).PRN 

0A> TYPE LINK.DO 

L80 (1).REL(2}/E,(1).COM/N 

DELETE {1}.REL 

0A) 


Do-filesmay be nested in this fashion to any 
reasonable depth. 

If the last command in a do-file is a DO 
command which reinvokes the same do-file, 
then TurboDOS will repeatedly execute the do- 
file over and over again. In this case, it 
is important to omit the final RETURN and 
LINEFEED from the do-file; otherwise, Turbo¬ 
DOS will treat the DO command as recursive, 
and will eventually terminate execution when 
nesting becomes too deep. 
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Automatic Loading TurboDOS provides a simple means for automa¬ 
tically loading any program or executing any 
sequence of commands at initial start-up 
(cold start), or whenever a program termi¬ 
nates (warm start). You could use this fea¬ 
ture to cause automatic execution of an ap¬ 
plication function menu program or the LOGON 
command, for example. 

Autoload at cold-start takes place only if a 
file named COLDSTRT.AUT is present on the 
start-up disk. Autoload at warm-start takes 
place only if a file named WARMSTRT.AUT is 
present on the current disk. 


Program Autoload To cause a program or command to be loaded 

automatically, simply make a copy of the .COM 
or .CMD file under the name COLDSTRT.AUT or 
WARMSTRT.AUT as appropriate. For instance, 
for automatic LOGON operation, copy LOGON.COM 
(or .CMD) to WARMSTRT.AUT under user 31. 


Command Autoload To cause a command or string of commands to 

be executed automatically, use the AUTOLOAD 
command to capture the desired command string 
in a file called AUTOLOAD.AUT. Then rename 
this file to COLDSTRT.AUT or WARMSTRT.AUT as 
appropriate. For example, to automatically 
set the system date and then execute a BASIC 
program called MENU at each cold-start: 


0A) AUTOLOAD DATE SET I BASIC MENU 
Autoload file created. 

0A) RENAME AUTOLOAD.AUT COLDSTRT.AUT 
OA:AUTOLOAD.AUT renamed OA:COLDSTRT.AUT 
OA) 


Note that a newly-created .AUT file does not 
take effect until the next cold-start. 
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Networking As you know already, a multi-user TurboDOS 

system is actually a network of interconnec¬ 
ted microcomputers working together. A sepa¬ 
rate microcomputer supports each user's video 
console, and one or more additional microcom¬ 
puters may be used to manage disks, printers, 
communications channels, and other shared 
devices of the system. 

In general, you do not need to be concerned 
about the networking aspects of TurboDOS. 
When you read from drive C or print to prin¬ 
ter B, for example, you do not need to think 
about whether that disk drive is connected to 
your processor or to another processor in the 
network. TurboDOS automatically routes your 
requests to the proper destination without 
any explicit action on your part. 

However, there are a few cases in which you 
need to be conscious of the true multi-pro¬ 
cessor nature of the system. 


Local Commands A few TurboDOS commands require direct access 

to disk drive and controller hardware, and 
consequently may be executed only in the 
processor to which the disk is attached. 
These commands are: 


COPYF 

BOOT 

FMTF 

VERIFY 


Copy entire disk track-by-track 
Read/write reserved tracks 
Erase and initialize entire disk 
Scan entire disk for bad spots 


If you try to execute any of these commands 
in another processor, you will get the error 
message "Not ready error. Drive X". 
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Remote Console In many TurboDOS systems, disks and other 

shared peripherals are attached to a "master” 
or "server" processor which is separate from 
the processors to which user consoles are 
attached. If you need to run a program in 
the master processor (e.g., FMTF) , you 
would ordinarily have to hook up a console 
device to the master. However, TurboDOS has 
a special command which lets you temporarily 
assign your console to the master without 
making hardware changes (a special console 
driver must be installed in the master): 


5Q MASTER 

Console attached to master processor 
0A> FMTF B: 


0A> <Attention/Abort> 

Console detached from master processor 
50 


The MASTER command attaches your console to 
the master processor. To detach, key in the 
Attention/Abort sequence. 


Memory Management Microcomputers use random-access memory (RAM) 

to hold both programs and data. TurboDOS 
itself occupies a certain amount of memory, 
and it needs additional memory for disk buf¬ 
fers, print queues, file interlocks, and 
various other things. All the memory space 
that is left over is called the "Transient 
Program Area" (TPA), and is available for use 
by commands and application programs. 

Because memory is often a critical resource, 
it is important for you to understand how it 
is managed by TurboDOS. This varies depend¬ 
ing upon the hardware involved. 
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A non-banked Z80 configuration is limited by 
hardware constraints to a maximum of 64K of 
memory. TurboDOS resides in the topmost 
portion of memory, and allocates its disk 
buffers and other dynamic space requirements 
immediately below itself. The TPA occupies 
the lower portion of memory: 


TurboDOS 

1 

i 

1 12K-24K 

1 

Disk Buffers 

1 2K-8K 

1 

Dynamic Space 

1 

1 IK 

_ Transient 

1 

1 

1 

_l 

1 32K-50K 

_ Program Area 

1 

_l 

— 

— 


If you need additional TPA for a particular 
program, you can reduce the size of the disk 
buffer pool by using the BUFFERS command. 
However, you must make sure the system is 
quiescent (no programs running, no files 
open, no print jobs queued, etc.) so that 
there is no dynamic space allocated below the 
disk buffers. Then you can reduce the disk 
buffers and increase your TPA accordingly. 
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Banked Z80 


A banked Z80 configuration permits more than 
64K of memory by providing two memory banks 
(called "bank 0" and "bank 1"), only one of 
which may be active at a time. TurboDOS 
resides in bank 0 along with its disk buffers 
and other dynamic space, while the TPA occu¬ 
pies bank 1. 


In order to allow the necessary inter-bank 
communications to take place, an area of 
common (non-switched) memory must be provided 
at the top of memory. Ideally, this common 
area should be IK, permitting each memory 
bank to be 63K. However, hardware design 
often dictates that the common area be larger 
than this, often as big as 16K. A large 
common area reduces the memory available for 
TurboDOS, but does not reduce the TPA size: 


TurboDOS Bank Mgr. I IK 


Transient Program _ 
Area (Continued) 


6 3 K 
Total 
TPA 


TurboDOS 


Disk Buffers 


Dynamic Space 


Transient 

Program 

Area 


(Unused) 

_i 

i 


i 

(Bank 0) 



(Bank 1) 



4-11 











TurboDOS 1.4 PROCESSING 

User's Guide 

Memory Management 
(Continued) 


Copyright 1984 by Software 2000, Inc. 
All rights reserved. 


Banked Z80 Certain TurboDOS commands (COPYF, BOOT, 
(Continued) FMTF, and VERIFY) will not run in a banked 

TPA. So that you can use these commands, 
TurboDOS provides a BANK command which lets 
you change between the banked and non-banked 
configurations at will. 


80 86-Family 


In an 8086-family processor, TurboDOS 
occupies lower memory, with the TPA above: 



Since 8086-family processors can address up 
to a megabyte of memory directly, memory 
management is generally not a problem, and 
bank-switching is unnecessary. 


Summary In this section, you've learned how TurboDOS 

commands work, and various ways commands may 
be executed (command strings, do-files, auto¬ 
load). You also understand the effects of 
networking and memory management on your 
processing. 

Now we are ready to examine each TurboDOS 
command in detail. 
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COMMANDS This section describes each TurboDOS command 

in detail. For ease of reference, the com¬ 
mands are presented in alphabetical order. 

Presentation This section uses the following notation: 

. Keywords are shown in capital letters, 
and must be entered as shown. (You can 
use either upper- or lower-case.) 

Parameters are shown in lower-case, and 
are described in the following text. 

. Items shown in braces {} are optional. 
If you want to include such an optional 
item, do not type the braces, but only 
the information inside. 

. An ellipsis ... indicates that the pre¬ 
ceding item may be repeated as many 
times as you like. 

. Spaces and punctuation characters must 
be entered as shown (except for braces 
{} and el ipses ...). 

. Command options are usually introduced 
by semicolon; several options may be 
combined following a single semicolon. 

The command name and any file name arguments 
in the command tail may be prefixed by a 
drive letter, a user number, or both. Any of 
the following prefix formats are accepted: 


d:file uud:file uu:d:file 

uu:file duu:file d:uu:file 


where "d" is a drive letter (A-P) , "uu" is a 
user number (0-31) and "file" is a file name. 
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ALTSEC Command ALTSEC is an IMS Winchester alternate sector 

utility which allows bad sectors to be 
assigned to the alternate sector table on 
IMS Winchester drives that use the model 1100 
DMA Winchester controller. 

Syntax - 

I I 

I ALTSEC I 


Explanation The ALTSEC program contains an option 

allowing examination of the alternate sector 
table on a Winchester, and an option allowing 
verification of tracks on the Winchester. 

The ALTSEC program will sign-on and display 
the program name and revision number. The 
user will be prompted for the physical 
Winchester drive unit number. (Unit 0 is 
the first Winchester drive on a system, unit 
1 the second, etc.). 

The user will be asked to select on of 4 
options. These are: 
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Explanation 


Display the alternate sector 
table. Displays all the 
currently assigned in the 
alternate sector table on the 
Winchester drive. 

Assign a sector to the 
alternate sector table. The 
program attempts to recover 
the data in a bad sector. 

Verify a track and report 
errors. The number of errors 
that occurred reading each 
sector is displayed. This 
option is useful in determin¬ 
ing the exact location of bad 
sectors on particular tracks. 
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AUTOLOAD Command The AUTOLOAD command lets you set up a com¬ 
mand sequence to be executed automatically at 
each cold-start or warm-start. 


Syntax I 

I AUTOLOAD command {I command)... 


Explanation 


Example 


If you wish, TurboDOS will automatically load 
any program or execute any command sequence 
at initial start-up (cold-start), or at the 
conclusion of each program you run (warm- 
start). If the file COLDSTRT.AUT exists on 
the start-up disk, TurboDOS will execute it 
automatically at each cold-start. If the 
file WARMSTRT.AUT exists on the current disk, 
TurboDOS will execute it automatically at 
each warm-start. 

You can use the AUTOLOAD command to create 
these .AUT files. The command tail consists 
of the command(s) to be executed automatical¬ 
ly. Note that if multiple commands are 
given, they must be separated with the deli¬ 
miter I rather than \. 

The AUTOLOAD command always creates a file 
named AUTOLOAD.AUT on the current drive under 
the current user number. By renaming this 
file as COLDSTRT.AUT or WARMSTRT.AUT, you 
will cause the specified command(s) to be 
executed automatically at each cold-start or 
warm-start. A newly created .AUT file does 
not affect system operation until the next 
system start-up. 


OA) AUTOLOAD DATE, SET I BAS.IC_MEMU 
Auto load file created 
0A) RENAME AUTOLOAD.AUT COLDSTRT.AUT 
OA:AUTOLOAD.AUT renamed OA:COLDSTRT.AUT 
OA) 
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Error Messages 


I Error creating auto load file 


Patch Points I. £8 0 1 m 8£_i. Yal-J_ 

I 

I 103H CS+4 "I" Special delimiter 

I 104H CS+5 "\" Normal delimiter 
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BANK Command In a banked Z80 system, the BANK command lets 

you change from bank-switched to non-bank- 
switched operation, and vice versa. 


Syntax 


Explanation 


Examples 


BANK 0 
BANK 1 
BANK 


The first form selects the non-bank-switched 
mode of operation in which the TPA resides in 
memory bank 0 (along with TurboDOS). There 
must be sufficient free memory in bank 0 for 
at least a minimal TPA, otherwise an error is 
diagnosed and bank 1 remains active. 

The second form selects the bank-switched 
mode in which the TPA occupies bank 1. The 
third form displays the current bank mode. 

The BANK command has no effect in a non- 
banked system, and always shows that bank 0 
is selected. Use of this command is restric¬ 
ted to privileged log-ons only. 


I QA> BANK 

I Current bank number: 1 
I OA) BANK Q 

I Current bank number: 0 
I 0A> 


Error Messages I 

I Invalid bank number requested 
I Insufficient memory in bank 0 
I Non-privileged user 


5-6 




TurboDOS 1.4 
User's Guide 


BATCH Command 


Syntax 


Explanation 


Example 


COMMANDS 
BATCH Command 


Copyright 1984 by Software 2000, Inc. 
All rights reserved. 


The BATCH command provides a convenient way 
of entering TurboDOS command strings into a 
FIFO for processing by a dedicated batch 
processor in a networking system. 


I BATCH command {I command}... I 


To make use of the BATCH command, you must 
have previously set up a FIFO with the stan¬ 
dard name BATCH.DO; in most cases, this FIFO 
should be set up as a global file under user 
number 0 on drive A, and should have the 
"suspend" option selected (see FIFO command). 
The batch processor executes the command "DO 
BATCH" (usually autoloaded) at system start¬ 
up. Thereafter, any command string written 
to the FIFO will wake up the batch processor 
and be executed. Whenever the FIFO becomes 
empty, the batch processor will be suspended 
awaiting additional work to do. 

You can use the BATCH command to write any 
command or string of commands to the FIFO. 
If multiple commands are given in the BATCH 
command tail, they must be separated with the 
delimiter i rather than \. BATCH writes the 
command(s) to BATCH.DO, converting each ! to 
a \ and prefixing the command string with 
commands to select the proper drive and user 
number. 


5C} MXC1L_PA£M__PE0C1K£L C . V T.._PK0G 
Message sent to FIFO 
50 


The command above writes the following text 
to BATCH.DO: 

5C:\PASM PROG\RELCVT PROG 


5-7 






TurboDOS 1.4 COMMANDS 

User's Guide 

BATCH Command 
(Continued) 


Copyright 1984 by Software 2000, Inc. 
All rights reserved. 


Error Messages 


Patch Points 


BATCH.DO 

FIFO 

not 

found 

BATCH.DO 

f ile 

not 

FIFO 

BATCH.DO 

FIFO 

is 

full 


I Excessive command length 


Z80 1 

8086 

1 Val 

l_ Description 

103H 

CS+4 

it | n 

Special delimiter 

104H 

CS+5 

ii it 

Normal delimiter 

105H 

CS+6 

0 

Drive for BATCH.DO 
(0=A, 1=B,..., 15=P) 
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The BOOT command lets you access any reserved 
tracks ("boot tracks") on a disk. 


BOOT s: destfile 
BOOT srcefile d: 
BOOT s: d: 


Some hardware configurations require that 
certain tracks on a disk be reserved (e.g., 
for a cold-start loader or alternate track 
table). The BOOT command provides a means 
for reading, writing, or copying such re¬ 
served tracks. 

The first form reads the reserved tracks from 
the source drive "s:" and writes the data to 
the destination file "destfile". The 
second form reads a source file "srcefile" 
and writes the contents to the reserved 
tracks on destination drive "d:". The last 
form copies the reserved tracks from source 
drive "s:" to destination drive "d:". 

The BOOT command reads the entire source 
(tracks or file) into memory before writing 
the data out to the destination (tracks or 
file). If the source is too big to fit into 
the TPA, you will get an error message. 

The disk(s) containing boot tracks to be read 
or written must be attached to the processor 
in which the command is executed. In a Z80 
banked-memory system, the command must be 
executed from bank 0. Use of the BOOT com¬ 
mand is restricted to privileged log-ons. 
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Examples I 

I OA} BOOT B: BOOTSAVE.SYS 
I Reading boot tracks: *** 

I Writing destination file: 
I Operation successful 
I OA} BOOT BOOTCODE.SYS B: 

I Reading source file: .... 

I Writing boot tracks: *** 

I Operation successful 
I 0A) BOOT B: A: 

I Reading boot tracks: *** 

I Writing boot tracks: *** 

I Operation successful 
I OA} 


Error Messages I 

I Non-privileged user 
I No source drive/filename specified 
I No destination drive/filename specified 
I Can't find source file 
I Can't read boot tracks 
I Can't write destination file 
I Can't write boot tracks 
I Not enough memory 
I Unable to execute from bank 1 
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BUFFERS Command 


Syntax 


The BUFFERS command lets you change the 
number and/or size of disk buffers maintained 
by TurboDOS. 


I BUFFERS {Nnumber) (Ssize) 


Explanation The BUFFERS command sets the number of buf¬ 

fers to "number" and the buffer size to 
"size". The minimum number of buffers al¬ 
lowed by TurboDOS is 2. The buffer size is 
given in decimal bytes, and must be one of 
the following: 128, 256, 512, 1024, 2048, 

4096, 8192, or 16384. The buffer size should 
not be smaller than the physical sector size 
of the disks being used. 

If there is not enough memory to allocate the 
requested number of buffers of the specified 
size, the BUFFERS command will allocate as 
many as it can. If either the "N" or "S" 
argument is omitted, the corresponding para¬ 
meter remains unchanged. If both are omit¬ 
ted, the command simply displays the current 
parameters. 

The use of the BUFFERS command to change 
buffer parameters is restricted to privileged 
log-ons only. In a networking system, if the 
BUFFERS command is executed in a slave pro¬ 
cessor without any local disk storage, then 
it refers to the buffer pool in the master 
processor. 


Example 

1 

1 

1 

0A)BUFFERS N6 
Number of buffers: 

6 



1 

Length of buffers: 

1024 



1 

1 

0 A) 
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Error Messages 


Non-privileged user 
Minimum number of buffers = 2 
Maximum number of buffers = 255 
Invalid buffer size requested 
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You must use CHANGE before removing a disk 
from any drive on a multi-user system. 


I CHANGE {drivelist} 


The command tail consists of a list of drive 
letters A...P corresponding to the disks that 
you want to change, or an asterisk * if you 
want to change all disks. If you omit the 
drive list, CHANGE will prompt you for it. 
Before shutting down a multi-user TurboDOS 
system, it is a good idea to enter the com¬ 
mand "CHANGE *". 

If any of the drives you request are in use 
by another user, your request will be denied. 
Otherwise, you will be prompted to change the 
requested disk(s), and to enter RETURN when 
you are done. Until you have pressed RETURN, 
no other user will be allowed to access the 
disk(s) that you are changing. 


Options 


Examples 


Error Messages 


Option 

. Explanation . . 

1 

; N 

Pause for RETURN is bypassed. 

1 

1 

1 



— 


0 A} CHANGE. BCD 
Change drive(s) BCD 

Enter <CR> when change complete [RETURN] 
0 A > CHANGE—*^,; N 

Change drive(s) ABCDEFGHIJKLMNOP 
0A> 


Invalid drive(s) requested 
Following drive(s) in use: d... 
Unable to free drive(s): d... 


CHANGE Command 

Syntax 

Explanation 
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The CLOCK command is used to read or set the 
date and time stored in the real time clock 
on your IMS system. 


I CLOCK ;options 


The CLOCK command will allow the user to read 
and display the time and date, display the 
time in military time, set the time, or view 
the time continuously. The user must be 
attached to the master to use this command 
(See the MASTER command). In systems with 
banked memory, CLOCK must be executed in a 
single-user, non-banked configuration. 

NOTE: After changing date and time, the 
DATE command must be executed to update 
TurboDOS' internal day-month-year hour- 
minute-second-tick counters. See DATE 
command in this chapter. 


Option I Explanation 

;R Read and display the time and 

date. 

;M Military time. 

;S Set the time. 

;V View time continuously, updating 

every second. 
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Error Messages 


Can't read the clock chip 
Invalid option specified 
Invalid entry 

Must attach to the master to run CLOCK 


5-15 



TurboDOS 1.4 
User's Guide 


COPY Command 

Syntax 

Explanation 


COMMANDS 
COPY Command 


Copyright 1984 by Software 2000, Inc. 
All rights reserved. 


The COPY command lets you copy individual 
disk files or groups of files. 


I COPY srcefile destfile {;options> I 

! COPY {;options} I 


The COPY command makes a copy of the file 
specified by "srcefile". The new file is 
created on the drive and with the filename 
specified by "destfile". 

You may use wild-card characters (? and *) in 
the "srcefile" argument to indicate that 
multiple files are to be copied. Wild-card 
characters may also be used in the "destfile" 
argument to indicate that the corresponding 
characters of each source filename are to be 
used in the destination filename. 

If you give a "srcefile" or "destfile" argu¬ 
ment consisting of only a drive letter and/or 
user number prefix, COPY assumes a filename 
of all wild cards (in other words, C: is 
equivalent to C:*.*). 

If you omit both "srcefile" and "destfile" 
from the command (second form), then the COPY 
command operates in an interactive mode. You 
are prompted by an asterisk * to enter a 
series of directives from the console. The 
syntax of each directive is: 


I srcefile destfile {;options} 


Options specified within a directive take 
precedence over options specified in the COPY 
command itself. A null directive (RETURN 
only) terminates the COPY command. 
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Option _L_Explanation_ 

;A Only source files without the 

"archived" attribute are copied. 
These source files are given the 
"archived" attribute after they 
are copied. This provides a 
means for incremental backup of 
large disks. 

;B Allows a large source file to be 

copied in sections to multiple 
destination disks, or to restore 
such a file from multiple source 
disks. If this option is speci¬ 
fied, the "srcefile" argument 
cannot contain wild cards. 

;C If the destination fills up, 

COPY allows you to change the 
disk in the destination drive 
and continue copying. This is 
useful when backing up a hard 
disk to floppy disks. 

;E COPY erases each source file 

after copying to destination. 

;N If "srcefile" contains wild 

cards, COPY does not ask you for 
confirmation before copying each 
file. If a destination file al¬ 
ready exists, COPY does not ask 
you for confirmation before de¬ 
leting it. 

;R COPY replaces files on the des¬ 

tination disk, but doesn't copy 
files that don't already exist 
on the destination disk 
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-QP-ti-on_ L_ __E xplanation ___ 

;X Copying is not performed if the 

destination file already exists. 

;Y If "srcefile" contains wild 

cards, COPY asks you for confir¬ 
mation before copying each file. 
If a destination file already 
exists, COPY asks you for con¬ 
firmation before deleting it. 


OA) COPY *.BAS B: :N 

0A:AMORTIZE.BAS copied to OB:AMORTIZE.BAS 
OA:PRIMES .BAS copied to OB:PRIMES .BAS 
OB:STARTREK.BAS already exists, deleted 
OA:STARTREK.BAS copied to OB:STARTREK.BAS 
OA) COPY 

* AUTOLOAD.COM B: :E 

OA:AUTOLOAD.COM copied to OB:AUTOLOAD.COM 
OA:AUTOLOAD.COM deleted 

* [RETURN] 

0A> 


and for privileged log-ons: 


0 A1 ,C..QPY_*_. 
OA:STOCKS 
OA:STOCKS 
OA:BONDS 
OA:BONDS 
OA) 


DAT_ 7B: i N E 

.DAT copied to 7B:STOCKS 
.DAT deleted 
.DAT copied to 7B:BONDS 
.DAT deleted 


.DAT 

.DAT 
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Error Messages 


Invalid filename 1 
Invalid filename 2 

Ambiguous filename not permitted with 
option B 

Destination drive read-only 
<filename> copy to same filename 
<filename> FIFO file, not copied 
File not found 

Unable to lock destination drive 
Unable to free drive 
Unable to open source file 
Unable to create destination file 
Unable to read source file 
Unable to write destination file 
Unable to close source file 
Unable to close destination file 
Unable to set attributes on source file 
Unable to set attributes on destination 
file 

Insufficient memory 
Non-privileged user 
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The COPYF command performs a fast copy of an 
entire disk onto another disk of the same 
type and format, and is generally used to 
backup floppy diskettes. 


I COPYF s: d: 


COPYF performs a track-by-track copy of the 
source disk "s: H on to the destination disk 
"d:". Both diskettes must be of exactly the 
same type and format. The user must be 
attached to the master processor (see the 
MASTER command). In banked memory systems, 
COPYF must be run in a single-user, non- 
banked configuration. 


OA) COPYF A: B: 

PROG ID: COPYF Revision 2.0 

IMS INTERNATIONAL 

Copy Floppy Disk Utility 

... parameters displayed ... 
Source drive: A 
Destination driver: B 
<cr> to continue or ~C to abort 
[RETURN] 

Copyingcylinder x 

Copy complete -- 
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Error Messages 


Non-privileged user 
No source drive specified 
No destination drive specified 
Unable to lockout source drive 
Unable to lockout destination drive 
Source drive not ready 
Destination drive not ready 
Disk types not identical 
Insufficient memory for copy 
Read error. Drive: d. Track: nn 
Write error, Drive: d. Track: nn 
Unable to execute from bank 1 
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DATE Command 


Syntax 


The DATE command lets you set or display the 
system date and time. 


I DATE {SET} 


Explanation 


If "SET" is specified, the DATE command 
prompts you interactively to enter the new 
system date and time. The required format 
for the date is "dd mmm y y", and for the time 
"hh:mm:ss" (see Examples). You may leave the 
date or time unchanged by typing RETURN in 
response to the prompt. 


If "SET" is not specified, the DATE command 
simply displays the current system date and 
time. 


Examples 


0A}DAIE-SE.T 
Date: 07 Dec 41 
Time: 16:15:00 
0A) DATE 

Date: 07 Dec 41 
Time: 16:15:08 
0A> 
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DELETE Command The DELETE command lets you delete individual 

disk files or groups of files. 


Syntax I I 

I DELETE filename {;options} I 

I DELETE {yoptions} I 


Explanation The DELETE command permanently deletes the 

file specified by "filename" from disk. 

You may use wild-card characters (? and *) in 
the "filename" argument to indicate that 
multiple files are to be deleted. 

If you omit "filename" from the command 
(second form), then the DELETE command oper¬ 
ates in an interactive mode. You are promp¬ 
ted by an asterisk * to enter a series of 
directives from the console. The syntax of 
each directive is: 


I filename (;options} 


Options specified within a directive take 
precedence over options specified in the 
DELETE command itself. A null directive 
(RETURN only) terminates the DELETE command. 


Options 


.Option. I _Ex planation __ 

;N If "filename" contains wild 

cards, DELETE does not ask you 
for confirmation before deleting 
each file. 

;Y If "filename" contains wild 

cards, DELETE asks you for con¬ 
firmation before deleting each 
file. 
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Examples 


Error Messages 


QA) DELET E . *.BAS. ;N 
0A:AMORTIZE.BAS deleted 
0A:PRIMES .BAS deleted 
0A:STARTREK.BAS deleted 
0A> DELETE B:MAXI*.* :Y 
OB:MAXICOMP.TXT OK to delete (y/n)? N 

OB:MAXIMUMS.COM OK to delete (y/n)? X 

OBrMAXIMUMS.COM deleted 

0B:MAXIMUMS.ASM OK to delete (y/n)? X 

0B:MAXIMUMS.ASM deleted 
0A} DELETE 

* AUTOLOAD.COM 
OArAUTOLOAD.COM deleted 

* *.TXT ;N 

OArREFERENC.TXT deleted 
OArUSERGUID.TXT deleted 

* I&ETDmU 

OA) 

and for privileged log-onsr 

0A)DEL ETE . ?P;*tP AT. ;N 
7Br STOCKS .DAT deleted 
7B rBONDS .DAT deleted 
OA) 


Destination drive read-only 
<filename> read-only, not deleted 
<filename> FIFO file, not deleted 
File not found 
Invalid filename 
Insufficient memory 
Network error 
Non-privileged user 
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The DIR command displays an alphabetized disk 
directory on the console or printer. 


DIR filename {;options} 
DIR prefix: {;options> 
DIR {;options} 


The "filename" argument generally contains 
wild-card characters (? and *), and specifies 
the user number, drive letter, and group of 
files to be included in the directory. If 
you specify only a drive letter and/or user 
number prefix (second form), all files on the 
specified drive/user are displayed. If you 
omit the filename argument altogether (third 
form), all files on the current drive/user 
are displayed. 

In all cases, the directory display starts 
out with a preamble containing the following 
information: 

. user number, drive, and "filename" 

. disk label 

. current date and time 

. hashed directory indicator: (II) 

. free space remaining on disk 
. number of files displayed 
. combined size of files displayed 

This preamble is followed by an alphabetized 
list of filenames, with the size of each file 
shown. Read-only files are distinguished by 
a colon : (rather than a period .) between 
the filename and filetype. 

If there are too many files to fit on the 
screen, DIR waits at the end of each screen- 
full for you to press RETURN. 
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Options I Option I_Ex planatio n_ 

I 

I ;L The directory is printed rather 

I than displayed on the console. 


Examples I 

I 0A)DX R. iI l 

I ...(printout of all 0A: files)... 
i 0A) DIR B: 

I ...(display of all OB: files)... 
i 0 Al 

i 

I and for privileged log-ons: 

I 

I 0A) DIR 5: 

I ...(display of all 5A: files)... 

I 0A) DIR 7B:*.DAT 

! ...(display of only 7B:*.DAT files)... 
I 0A> 


Error Messages 


Insufficient memory 
Network error 
Non-privileged user 


Patch Points 


Z80- 1 , 80 86 _ .I _ ya l_J_^scxiptiou_ 

103H CS+4 3 Left margin for ?L opt 
104H CS+5 " a L" Clear-screen character 
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The DO command lets you execute a pre-defined 
sequence of TurboDOS commands which you have 
previously saved in a disk file. 


I DO filename {argl arg2 ... argN} 


The "filename" argument specifies the file of 
TurboDOS commands to be executed (called the 
"do-file"). If "filename" does not specify 
an explicit filetype, then .DO is assumed. 
The DO command causes the commands contained 
in the do-file to be executed in sequence. A 
do-file may contain embedded DO commands, and 
TurboDOS supports such "nesting" of do-files 
to any reasonable depth. 

The optional arguments "argl" through "argN" 
are substituted into marked locations in the 
do-file. Any number of arguments is permit¬ 
ted. If arguments contain embedded spaces, 
they must be enclosed in single or double 
quotes. The presence of one or more of these 
arguments causes the DO command to make a 
temporary copy of the do-file in which the 
arguments are substituted as required. The 
commands in the temporary file are then exe¬ 
cuted in sequence. The temporary file is 
given the same filename as the original do- 
file, except that the last character of the 
filetype is changed to a dollar sign (e.g., 
GENERATE.DO is copied to GENERATE.DO$). The 
last entry in the temporary file is a DELETE 
command which causes the temporary file to be 
deleted. 

The do-file is simply a text file, each line 
of which contains a valid TurboDOS command or 
command string. You can create do-files with 
any text editing program. 
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If argument substitution is desired, then you 
must mark each substitution point in the do- 
file by enclosing the argument number in 
braces O. For example, (3> in the do-file 
will be replaced by the value of "arg3" of 
the DO command. A default value may follow 
the argument number, separated by a comma 
({3, TEMP} for example), and will be used if 
the corresponding argument of the DO command 
is missing or null. 

Note that if a do-file contains such marked 
substitution points, then the invoking DO 
command musi contain at least one substitu¬ 
tion argument to trigger the substitution 
process. A null argument such as "" or '' is 
sufficient. 

Certain commands (such as COPY, RENAME and 
DELETE) and other programs expect interactive 
input from the console. If such a command or 
program is executed within a do-file, then 
its console input comes from the do-file 
rather than the console (in most cases). 

If the last entry in a do-file is a DO com¬ 
mand that reinvokes the same do-file, the 
trailing RETURN/LINEFEED should be omitted to 
avoid recursion that is nested too deeply. 

Examples See preceding section on Batch Processing for 

examples of the DO command. 


Explanation 

(Continued) 


Error Messages I 

I Unable to activate DO file 
1 Non-privileged user 


Patch Points L.Z80_l_ 80_1 Val I _ Description _ 

I 

I 103H CS+4 Left param delimiter 

I 104H CS+5 Right param delimiter 
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DRIVE Command The DRIVE command displays information about 

the format of a disk. 


Syntax 


Explanation 


Options 


Example 


Error Messages 


I DRIVE {d:} {;options> 


The DRIVE command displays the format of the 
disk specified by the "d: n argument, as shown 
in the example below. If you omit the "d:" 
argument, then the format of the disk in the 
current drive is displayed. The display may 
be on the console or printer. 


Option_L_ Expla nation _ 

;L The disk format information is 

printed, rather than displayed 
on the console. 


OA) DRIVE B: 

Disk format, drive B:DOCUMENT.TXT 


Maximum data capacity : 1224K 

Allocation block size : 2K 

Number of directory entries: 1024 
Physical sector size : 1024 

Physical sectors per track : 16 
Physical tracks per disk : 77 
Number of reserved tracks : 0 
Removable media 
0A} 


1 



_i 

1 

1 Network error 

1 



1 

1 

1 
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DUMP Command 


Syntax 


The DUMP command displays a combined hexa¬ 
decimal and ASCII file dump on the console or 
printer. 


I DUMP filename {;options> 


Explanation The DUMP command displays the contents of the 

file specified by "filename" in both hexa¬ 
decimal and ASCII formats. The dump may be 
directed to either the console or printer. 


Options 


Examples 


Error Messages 


1 Option 

Explanation 1 

i ;L 

1 

The dump is printed, rather than ! 
displayed on the console. 1 



0A) DUMP B:DUMP.COM 

...(hex/ASCII dump of OB:DUMP.COM)... 
0A> 


and for privileged log-ons: 

0A} DUMP 7B:BONDS.DAT 

...(hex/ASCII dump of 7B:BONDS.DAT)... 
0A> 


File not found 
Non-privileged user 


5-30 





TurboDOS 1-4 
User's Guide 


COMMANDS 


ERASEDIR Command 


Copyright 1984 by Software 2000, Inc. 
All rights reserved. 


ERASEDIR Command 


Syntax 


Explanation 


The ERASEDIR command lets you erase the 
entire directory of a disk. 


I ERASEDIR d: 


The ERASEDIR command erases all files on the 
disk specified by the "d:" argument, regard¬ 
less of user number or read-only attributes. 
It also lets you specify whether the newly- 
initialized directory should be maintained in 
linear or hashed format. 


WARNING: Once you use this command, all files 
on the disk are lost forever. Use caution. 

Use of the ERASEDIR command is restricted to 
privileged log-ons only. 


Example I I 

I 0A} ERASEDIR B: I 
I Hashed directory desired (Y/N)? Y I 
I OK to erase directory on drive B (Y/N)? Y I 
I Erasing directory I 
I Directory erased, hashed I 
I 0A> I 


Error Messages I 

i Non-privileged user 
I No drive specified 
I Unable to erase directory 
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FIFO Command 

Syntax 


The FIFO command lets you create FIFO files. 


FIFO filename 


Explanation FIFO's are special files supported by 

TurboDOS to facilitate communications between 
users and processors. More details may be 
found in the TurboDOS Programmers Guide. 

If the FIFO identified by "filename" already 
exists, then the FIFO command displays its 
characteristics. Otherwise, the FIFO command 
prompts you interactively for the necessary 
parameters to create a new FIFO. 


Examples I 

I OA) FIFO B:BATCH.DO 

I FIFO file not found, creating new file 
I Enter FIFO type (Ram/Disk) : I) 

I Suspend processing on full/empty (Y/N): Y 
I Enter max nbr of records (1-65535): 1000 
I FIFO file created 
i 0A} FIFO B:BATCH.DO 
I FIFO is Disk resident 

I FIFO does suspend process on full/empty 
I Maximum number of records: 1000 
I Current number of records: 0 
I 0A) 


Error Messages I 

I No FIFO file name specified 
I File not FIFO 
I Unable to create FIFO file 
I Unable to read FIFO file header 
I Non-privileged user 
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FIXDIR Command The FIXDIR command lets you reorganize a disk 

directory whenever frequent additions and 
deletions of files have caused directory 
access to become less efficient. FIXDIR also 
lets you convert a disk directory from linear 
to hashed or vice-versa. 


Syntax 


Explanation 


I FIXDIR d: 


The FIXDIR command reorganizes the directory 
on the disk specified by the "d:" argument. 
It also lets you specify whether the newly- 
reorganized directory should be maintained in 
linear or hashed format. 

For linear directories, FIXDIR eliminates all 
deleted entries and compresses all directory 
entries at the beginning of the directory 
area. For hashed directories, FIXDIR re¬ 
hashes each entry to ensure optimum access 
efficiency. 

You cannot use FIXDIR on a drive that is in 
use by another user. Use of the FIXDIR com¬ 
mand is restricted to privileged log-ons 
only. 

WARNING: Execution of FIXDIR cannot be 
interrupted by an "attention" from the con¬ 
sole. Any attempt to abort via hardware 
reset is likely to result in loss of one or 
more files. It is a good idea to make a 
backup copy of the disk before using FIXDIR. 

WARNING: If conversion from linear to hashed 
format (or vice-versa) is requested, FIXDIR 
may take a long time (in extreme cases, 
hours). Do not attempt conversion unless 
adequate time is available to complete the 
operation. Also, it is wise to make a backup 
copy of the disk before using FIXDIR. 
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WARNING: Conversion from linear to hashed 
format may occasionally require more than one 
FIXDIR pass to ensure proper hashing of all 
directory entries. If you encounter trouble 
accessing certain files after conversion to 
hashed format, simply run FIXDIR again. 


I PA) FIXDIR B: I 
I Hashed directory desired (Y/N)? Y I 
I OK to reorganize directory on drive B? Y I 
I Reorganizing directory-DO NOT INTERRUPT I 
I Directory reorganized, hashed I 
I 0A) I 


Error Messages 


I Non-privileged user 

I No drive specified 

I Unable to reorganize directory 
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FIXMAP Command The FIXMAP command lets you regenerate the 

allocation map for a disk. 


Syntax 


Explanation 


I FIXMAP d: 


In order to keep track of which blocks of 
disk space are occupied and which are free, 
TurboDOS maintains on each disk an allocation 
map for that disk's space. Certain program 
malfunctions (failure to close a newly- 
created file, for example) can create dis¬ 
crepancies between the allocation map and the 
directory of a disk. The result is that disk 
blocks may occasionally become unavailable. 

The FIXMAP command regenerates the allocation 
map on the disk specified by the "d:" argu¬ 
ment, thereby reclaiming any disk blocks that 
may have become unavailable in this fashion. 

You cannot use FIXMAP on a drive that is in 
use by another user. Use of the FIXMAP com¬ 
mand is restricted to privileged log-ons 
only. 



Examples 


QA> FIXMAP B: 

OK to regenerate disk map on drive B? Y 
Regenerating disk map 
Disk map regenerated 
QA> FIXMAP C: 

OK to regenerate disk map on drive C? Y 
Regenerating disk map 

Disk map regenerated, 3 blocks gained 
0A} 
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Error Messages 


Unable to regenerate disk map 
Non-privileged user 
No drive specified 
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FMTF Command 


Syntax 


You must use the FMTF command to pre-record 
format information on each new disk before it 
is used for the first time. 


I FMTF d: {;options} 


Explanation 


The FMTF command initializes and then veri¬ 
fies the disk identified by "d:", which must 
be attached to the processor in which the 
command is executed.Useofthe FMTF command 
is restricted to privileged log-ons only. In 
systems with banked memory, FMTF must be run 
in a single-user, non-banked configuration. 

WARNING: Once you use this command, all files 
on the disk are lost forever. Use caution. 


If the hardware supports multiple disk for¬ 
mats, the FMTF command may require certain 
hardware-dependent options to specify the 
particular format desired. If you don't 
include all of the necessary options in the 
command, then FMTF will prompt you for them 
interactively. The examples below are typi¬ 
cal for floppy disks. 


Options 


Option 

1 _ . . _ _ Explanation 


; C 

CP/M Sector size 


; T 

TurboDOS sector size 


;s 

Single-density 


; D 

Double-density 


; 1 

Single-sided 


? 2 

Double-sided 
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Options 

(Continued) 


Example 


Option I Explanation 


;V FMTF performs only the verify 

pass (and omits the formatting 
pass). 

;4 40-track minifloppy (48 tpi) 

;8 80-track minifloppy (96 tpi) 


0A> FMTF B: 

PROG ID:FMTF Revision 2.0 

IMS INTERNATIONAL 

Floppy Disk Format Utility 

TurboDOS or CP/M format (T/C)? T 

Single- or double-density (S/D)? D 

One- or two-sided (1/2)? 2 

Selected sector size type: T 

Selected density: D 

Selected number of sides: 2 

FMTF will format diskette in drive B 

Type <CR> to continue, <CTRL-C> to abort 

? [RETURN! 

Formatting cylinder xx 

— Format complete — 

Verifying cylinder xx 

— Verify complete — 

OAl 
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Error Messages 


Non-privileged user 
Unable to lockout format drive 
Insufficient memory to verify 
Invalid drive specified 
Specified drive is not a floppy drive 
Drive is single-sided, unable to format 
double sided 
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The FMTW command is used to pre-record format 
information on each new winchester disk be¬ 
fore it is used for the first time. 


FMTW d: 


The FMTW command initializes and then veri¬ 
fies the disk identified by "d:", which must 
be attached to the processor in which the 
command is executed (See the MASTER command). 
FMTW also records the bad sectors on the 
disk. Use of the FMTW command is restricted 
to privileged log-ons only. In systems with 
banked memory, FMTF must be run in a single- 
user, non-banked configuration. 

This program will ask for a list of bad 
sectors. The list can be found on the side 
of the drive. FMTW will mark the bad sectors 
and check if there are any more. FMTF will 
list the bad sectors on the console or a 
printer. If there are more than 17 sectors 

on an 8" drive or 18 bad sectors on a 5" 
drive, the rest of the bad sector list should 
be entered using the WALT command. 

This command can be aborted by typing a 
control-C. 

WARNING: Once you use this command, all files 
on the disk are lost forever. Use caution. 
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Example I 

I 0A} FMTW B: 

I PROG ID:FMTW Revision 1.0 

I IMS INTERNATIONAL 
I Winchester Format Utility 
I More than one logical unit(Y/N)?^ 

I Any bad sectors(Y/N)?N 

I Enter <CR> to begin formatting: [RETURN] 
I Formatting cylinder xx 
I — Format complete -- 
I Verifying cylinder xx 
I — Verify complete -- 
I — No bad sectors — 

I 0A} 


Error Messages I 

I Non-privileged user 
I Unable to lockout format drive 
I Insufficient memory to verify 
I Invalid drive specified 
I Specified drive is not a winchester 
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FMTWIN Command FMTWIN is an IMS Winchester format utility 

used for formatting IMS Winchester drives 
with IMS model 1100 DMA Winchester 
controllers. This program must be run on a 
single-user system. 


Syntax - 

I 

I FMTWIN 


Explanation This program formats and verifies IMS 

Winchester disk drives. The program will 
sequentially format every track on the drive, 
and then sequentially verify every track. 
Verification consists of performing reads, 
verifying the data was read successfully, 
and reporting any errors encountered. 

Bad sectors assigned by the user are 
recorded and written on Track 0 (in a "bad 
sector table", also known as "alternate 
sector table"), along with the physical 
drive specifications at the end of verifi¬ 
cation. 

The program contains an option allowing 
verification of previously formatted drives, 
and an option allowing drive specifications 
and bad sector information of previously 
formatted drives to be examined. 
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Options 


Option I Explanation 


1 Format and verify option will 
examine the Winchester and 
determine if the drive has been 
previously formatted with this 
utility. 

2 Verify drive only option will 
examine the drive to see if it 
is formatted. 

3 Display drive specifications 
and Bad Sector Table. The 
program will examine the drive 
to see if it is formatted and 
display the Bad Sector Table 
if the drive is formatted. 

4 Exit utility. 
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LABEL Command : ; The LABEL command lets put a volume label on 

a disk.,..... 


Syntax I j£m:t o-• 

i LABEL .utilename 


Explanation The LABEL command writes a new volume label 

on the disk identified in the "filename" 
argument (or the current drive if no drive 
letter is specified explicitly). The name 
and type fields of "filename" are used as the 
volume label. The volume label may be dis¬ 
played using the DIR or DRIVE commands. 


Example I 

I 0A> LABEL B:PAYABLES.DAT 
I Disk label written 
I 0A) DRIVE B: 

I Disk format, drive B:PAYABLES.DAT 
I ...(etc.)... 

I 0A> 


Error Messages I I 

I Unable to label disk I 

I Invalid disk label I 
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LOGOFF Command 


Syntax 


Explanation 


Examples 


In a multi-user system, the LOGOFF command 
lets you terminate your session. 


I LOGOFF 


Executing the LOGOFF command has the follow¬ 
ing effects: 

. current user number is set to 31 
. current drive is set to system disk 
. access to global files is inhibited 


The library for user number 31 normally con¬ 
tains only the LOGON command file and the 
USERID.SYS validation file (see LOGON com¬ 
mand). Consequently, no further activity can 
be performed until a successful LOGON has 
taken place. 


If the file SYSLOG.SYS 
user 31 library, then 
records the log-off in 


is also present in the 
LOGOFF automatically 
that file. 


I 50 LOGOFF 
I 31 A} 


Error Messages 


i Unable to log off 
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In a multi-user system, the LOGON command 
lets you start a new console session. 


I LOGON 


The LOGON command provides password-type 
security for the purpose of protecting pri¬ 
vate file libraries and preventing unauthor¬ 
ized access to the system. 

The LOGON command prompts you interactively 
to enter your user-id, and validates whatever 
you enter against a validation file called 
USERID.SYS in the user 31 library. This file 
is an ordinary text file which may be created 
with any text editing program, and contains 
an entry of the following format for each 
valid user-id: 


I userid,{password),uu{P},(d:},(cmdline) 


where "userid" and "password" are up to eight 
characters in length, "uu" is a user number 
(0-30), "d:" is a drive letter (A-P), and 

"cmdline" is any valid TurboDOS command line. 

If your user-id has an associated password 
specified in USERID.SYS, then the LOGON com¬ 
mand prompts you to enter a password, and 
validates it. If your user-id and password 
are both found to be valid, then the log-on 
succeeds. A successful log-on has the fol¬ 
lowing effects: 

. access to global files is enabled 
. "nn" sets current user number 
. "P" sets privileged user (if present) 

. "d:" sets current drive (if present) 

. "cmdline" is executed (if present) 
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Explanation 

(Continued) 


Example 


Error Messages 


Patch Points 


If the system date and time have not been set 
since start-up, LOGON prompts for and sets 
the date and time. 

If the file SYSLOG.SYS is present in the user 
31 library, then the LOGON command automa¬ 
tically records your log-on in that file. In 
this case, LOGON prompts you for an activity 
description, and records it in the log entry. 

It is common practice to make a copy of the 
LOGON command under the name WARMSTRT.AUT in 
the user 31 library, which causes LOGON to be 
executed automatically at start-up and imme¬ 
diately after each LOGOFF. 


3lA}Lfl£QN 
System log on 
Enter user id: Barbara 
Enter password: Shazam 
Enter date: 15 Apr 84 
Enter time: 14:25:30 
Enter activity: Pavrol1 
50 


Invalid user id 
Incorrect password 
Invalid date 
Unable to log on 


-Z80 1 80 86 _1_ v_al J _Dasexipiiim_ 

103H CS+4 "~L" Clear-screen character 
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MASTER Command The MASTER command lets you temporarily 

attach your console to the "master" processor 
in a network system. 


Syntax 


I MASTER 


Explanation In many TurboDOS systems, disks and other 

shared peripherals are attached to a "master" 
or "server" processor which is separate from 
the "slave" processors to which user consoles 
are attached. If you need to run a program 
in the master processor (the BACKUP, BOOT, 
FORMAT or VERIFY commands, for example), you 
can use the MASTER command to assign your 
console to the master temporarily. To detach 
from the master (and resume normal console 
operation), enter an Attention/Abort sequence 
(typically CTRL-0/CTRL-C) . 

While attached to the master, you can send 
attention requests to the master processor by 
using a special attention character (CTRL-A) 
instead of the regular one (CTRL-0). 

Use of the MASTER command is restricted to 
privileged log-ons only. Do not attempt to 
run MASTER from more than one console at a 
time. If you do, console output from the 
master will be randomly distributed across 
two or more consoles, and be undecipherable. 
If this should occur by mistake, simply de¬ 
tach all but one of the consoles. 

The MASTER command can be used only if the 
master processor operating system is confi¬ 
gured with a special remote console driver 
module CONREM. See the 
for details. 
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Example 


Error Messages 


Patch Points 


5Q MASTER 

Console attached to master processor 
OA) FORMAT B: 


0A}J C , T R h - S .] [ C TRL- C ] 

Console detached from master processor 
50 


Console already attached to master 

Non-privileged user 

Remote console driver not present 


Z80 I 8086 I Val. J_Dgscripjim _ 

103H CS+4 ,,/s A" Special attention char 

104H CS+5 " Normal attention char 
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The PRINT command lets you control routing of 
your print output. 


I PRINT {option}... 


The PRINT command may include one or more of 
the options described below. A PRINT command 
with no option arguments causes your current 
print routing to be displayed on the console. 
In a multi-user system, each user controls 
his own print routing independently. 


Option 1 _Explanation_ 

CONSOLE Print output is routed to your 
C console (not to a printer) 


DRIVE=d Drive "d" is used for spooling, 
D=d where "d" is a drive letter in 

the range A through P. 


FILE Print output is spooled to disk, 

F but not automatically queued for 

printing. 


OFF 

0 Print output is discarded. 


PRINTER=p 

P=p Print output is routed direct to 

printer "p" without spooling to 
disk, where "p" is a printer 
letter in the range A through P. 

QUEUE=q Print output is spooled to disk, 

Q=q and then automatically queued on 

queue "q" for printing, where 
"q" is a queue letter in the 
range A through P. 
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Examples 


0A} PRI NT . PRIV E= C ..Q.U.EU£.=A 
Printing is to SPOOLER on DRIVE C 
to QUEUE A 

0A) PRINT P=B 

Printing is to PRINTER B 
0 A> PRINT C 

Printing is to CONSOLE 
0A) PRINT 0 

Printing is to OFFLINE 
0A) 


Error Messages 


Invalid request 
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PRINTER Command The PRINTER command lets you control de¬ 

spooling on any selected printer. 


Syntax 


I PRINTER p (option)... 


Explanation 


Options 


The "p" argument is a printer letter in the 
range A through P, and identifies the printer 
to be controlled. The PRINTER command may 
include one or more of the options described 
below. A PRINT command with no option argu¬ 
ments causes the current status of printer 
"p" to be displayed on the console. In a 
multi-user system, any printer may be con¬ 
trolled from any console. 


Option 1 

Explanation 

BEGIN 

B 

Stop de-spooling to printer, and 
reposition current print job to 
start at the beginning again 
when de-spooling is resumed. 

GO 

G 

Resume de-spooling to printer 
after STOP or BEGIN. 

OFFLINE 

0 

Take printer offline at the end 
of current print job. No fur¬ 
ther de-spooled printing will be 
done, but printer is available 
for direct printing. 

QUEUE=q 

Q=q 

! 

! 

1 

De-spool to printer from print 
queue "q", where "q" is a queue 
letter in the range A through P. 

If printer is currently printing 
from another queue, the new as¬ 
signment takes effect at the end 
of the current print job. 
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Options 

(Continued) 


Examples 


Error Messages 


* 


-O p tion. . 1 _E^planati-on_ 

STOP Stop de-spooling to printer, 

S pending subsequent GO or TERMI¬ 

NATE. 

TERMINATE 

T Terminate the current print job, 

and continue with the next job 
in the queue. The terminated 
print file is not deleted, and 
may be manually requeued with 
the QUEUE command. 


OA) PRINTER B OUEUE=A 
Printer B Assigned to QUEUE A 
0A> PRINTER B STOP 

Printer B Assigned to QUEUE A (Stopped) 
0A> 


Invalid request 
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Inc. 


PRTWIN Command PRTWIN is an IMS Winchester partitioning 

utility which allows physical Winchester 
drives to be divided into a user-selected 
number of logical partitions. The utility 
is for IMS Winchester drives that use the 
model 1100 DMA Winchester controller. 

Syntax -■ 

I 

I PRTWIN 


Explanation The user will be prompted for the physical 

Winchester drive unit number. (Unit 0 is the 
first Winchester drive on a system, unit 1 is 
the second, etc.). 

The program will examine the selected 
Winchester and display the current logical 
partitioning of the drive. It will either 
display the number of logical partitions or 
indicate the drive is partitioned into CP/M 
compatible partitions. 

WARNING: After displaying the current 

partitioning of the drive, the program will 
display a warning message indicating that 
changing the logical partitioning will 
destroy existing data on the drive. Data 
is lostwhen changing logical partitioning 
because file directory locations change with 
different partitioning, making it no longer 
possible to access files on the drive. 
Therefore the user should "back-up" or save 
any pertinent files onthe Winchesterbefore 
changing its logical partitioning. 



5-54 





TurboDOS 1.4 
User's Guide 


COMMANDS 

PRTWIN Command 
(Continued) 


Copyright 1984 by Software 2000, Inc. 
All rights reserved. 


Next the program will prompt the user for the 
number of logical partitions be created. 
(The values are entered in decimal). 
Entering a value from 1 to 15, inclusive, 
will divide the drive into that many 
partitions. The drive will be divided into 
partitions of equal size. (Except the last 
partition, which will be whatever size is 
left) . 

After performing the partitioning, the 
program will display a message indicating the 
partitioning has been completed, and also a 
message reminding the user to use the 
ERASEDIR utility immediately after 
partitioning. 

The program will then cause the system to 
reboot. This is done so that TurboDOS will 
recognize the new logical partitioning of the 
drive. 

Next the user must run the TurboDOS ERASEDIR 
utility on all of the new logical partitions. 
This must be done because the directories of 
the new logical partitions contain data in 
the format of whatever the previous 
partitioning was, leaving the directories 
with invalid data. The ERASEDIR utility 
erases the invalid data in the directories. 
ERASEDIR must be run on each new logical 
partition. 

The logical partitioning information is 
stored on track 0 of the Winchester. It is 
tored in a single byte, and contains a value 
of 255 decimal (FF hex) for CP/M compatible 
partitioning, or the actual numbwer of 
logical partitions on the drive. 
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PUTLDR Command PUTLDR is used to write the operating system 

loader program, OSLOAD.COM, to the reserved 
tracks of device. 


Syntax 


PUTLDR 


Explanation 


Example 


Error Messages 


The PUTLDR will ask for a source drive where 
the OSLOAD program can be found. A carriage 
return in response will cause the currently 
logged on drive to be used. It will then ask 
for a destination drive. OSLOAD.COM will 
then be read into memory and written to the 
disk. A dot is displayed for each sector 
read and written. The user must be attached 
to the master processor (See the MASTER com¬ 
mand) . 


OA)PUTLDR 

Source drive: [RETURN] 
Destination drive: E 
Reading loader into memory 


Writing to destination drive 


Write complete 
OA) 


Insufficient memory to load 
Drive n has an invalid LPB 
Drive is not ready 
OSLOAD not found 
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QUEUE Command The QUEUE command lets you manually queue 

print files (or any text file) for de-spooled 
printing. 

Syntax I I 

I QUEUE filename (;options) I 

I QUEUE {;options} I 


Explanation The QUEUE command queues the file specified 

by "filename" for de-spooled printing. 

You may use wild-card characters (? and *) in 
the "filename" argument to indicate that 
multiple files are to be queued. 

If you omit "filename" from the command 
(second form), then the QUEUE command oper¬ 
ates in an interactive mode. You are promp¬ 
ted by an asterisk * to enter a series of 
directives from the console. The syntax of 
each directive is: 


I filename {;options> 


Options specified within a directive take 
precedence over options specified in the 
QUEUE command itself. A null directive 
(RETURN only) terminates the QUEUE command. 
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Options 


Example 


Error Messages 


Option 1_ Explanation 


?D 

Queued file(s) are to be deleted 
automatically after printing. 

;N 

If "filename" contains wild 
cards, QUEUE does not ask you 
for confirmation before each 
file is queued. 

;Q=q 

File(s) are queued on print 
queue "q", where "q" is a queue 
letter in the range A through P. 
(If this option is omitted, the 
queue specified in the last 

PRINT command is used.) 

?S 

Queued file(s) are to be saved 
after printing, not deleted. 

(If neither ;D nor ;S are speci¬ 
fied, then ;S is assumed.) 

;Y 

If "filename" contains wild 
cards, QUEUE asks you for con¬ 
firmation before each file is 
queued. 


0A) QUEUE -PRINT-.* :NDO=A 
0A:-PRINT- .008 queued 
OAs-PRINT- .014 queued 
0A:-PRINT- .020 queued 
0A) 


No queue letter available 
Invalid queue letter requested 
File not found 
Invalid filename 
Insufficient memory 
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RECEIVE Command 


Syntax 


Explanation 


Example 


The RECEIVE command reads one record from a 
FIFO and displays it on the console. 


I RECEIVE filename 


The "filename" argument specifies the FIFO to 
be read. The RECEIVE command is useful where 
FIFOs are used as message mailboxes in a 
multi-user system. 

Note that RECEIVE displays only one record. 
To display or print the entire contents of a 
FIFO, use the TYPE command instead. 


I 0A) RECEIVE MAILBOX.RWR 

I RONNIE: NEED TO MEET WITH YOU...TEDDY 
I 0A> 


Error Messages I 

I No FIFO file name specified 
I FIFO file not found 
i File not FIFO 
I FIFO file empty 
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RENAME Command The RENAME command lets you rename individual 

disk files or groups of files. 


Syntax I 

I RENAME oldname newname {;options} 
i RENAME (;options) 


Explanation The RENAME command changes the name of the 

file specified by "oldname" to the new name 
specified by "newname". The "oldname" argu¬ 
ment may have a drive letter and/or user 
number prefix. 

You may use wild-card characters (? and *) in 
the "oldname" argument to indicate that mul¬ 
tiple files are to be renamed. Wild-card 
characters may also be used in the "newname" 
argument to indicate that the corresponding 
characters of the old filename are to be used 
in the new filename. 

If you omit both "oldname" and "newname" from 
the command (second form), then the RENAME 
command operates in an interactive mode. You 
are prompted by an asterisk * to enter a 
series of directives from the console. The 
syntax of each directive is: 


oldname newname (;options) 


Options specified within a directive take 
precedence over options specified in the 
RENAME command itself. A null directive 
(RETURN only) terminates the RENAME command. 
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Options 


Examples 


Error Messages 


Option 1_Explanation_ 

;N If "oldname" contains wild 

cards, RENAME does not ask you 
for confirmation before renaming 
each file. 

;Y If "oldname" contains wild 

cards, RENAME asks you for con¬ 
firmation before renaming each 
file. 


0A} RENAME B;*.BAK *.PRV ;N 
OB:REFERENC. B AK renamed OB : REFERENC.PRV 


OB:USERGUID.BAK renamed OB:USERGUID.PRV 
0A) RENAME 

* LETTER.TXT *.BAK 

OArLETTER .TXT renamed 0A:LETTER. BAK 

* MAXIMUMS.COM OPT*.* 

0A:MAXIMUMS.COM renamed 0A:OPTIMUMS.COM 


* IKE TURN] 

0 A) 


Invalid drive letter usage 

Invalid user number usage 

Destination drive read only 

<filename> rename to same filename 

<filename> read only 

File not found 

Invalid filename 1 

Invalid filename 2 

Insufficient memory 

Network error 
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RESET Command RESET allows one or more slave to be reset 

from another slave attached to the master. 


Syntax I 

I RESET s 


Explanation The RESET command will reset the slave 

processor "s", where "s" is the letter 
for the slave. The RESET command can be used 
to reset more than one slave by entering a 
string of slave letters as the command tail. 
To reset all slaves, type in RESET * <cr>. 

RESET must be executed from the master. (See 
the MASTER command.) In systems with banked 
memory RESET must be run in bank 0. 

Examples - 

I I 
I 0A} R BS.E T .. A C I 
I Resetting Slaves AC I 
I 0A> RESET * I 
I Resetting Slaves ABCDEFGHIJKLMNOP I 
I 0A) I 


Error Messages - 

i 

I Non-privileged user 

I You must attach to the master to use 
I RESET 

I Invalid slave letter 
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SEND Command 


The SEND command lets you write a message to 
a FIFO. 


Syntax 


I SEND filename message 


Explanation The "filename" argument specifies the FIFO to 

be read, and "message" is any text you wish. 
The SEND command is useful where FIFOs are 
used as batch queues or message mailboxes in 
a multi-user system. 

Any occurrence of the vertical bar I in the 
"message" argument is replaced by the charac¬ 
ter backslant \, which is helpful if you are 
sending a command string to a batch queue. 


Examples I 

I 0 A} j? E.N. D - 3 AT . C H . t .P. Q ..D E L ET E,,*.. B AR _; N 

I Message sent to FIFO 

I 0A) SEND MAILBOX.EMK-TED:, NO_ DICE. ..RON 
I Message sent to FIFO 
I 0A) 


Error 

Messages 

1 

1 No FIFO file name specified 

1 FIFO file not found 

1 File not FIFO 

1 FIFO file full 

1 






Patch 

Points 

1 Z80 i 80 86- 1 _ Val. J_Description_ 



I 103H CS+4 "I" Special delimiter 

I 104H CS+5 "\" Normal delimiter 
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The SET command lets you set and clear file 
attributes. 


I SET filename joptions 
I SET {;options) 


The SET command changes the attributes of the 
file specified by the "filename" argument as 
requested in "options". 

You may use wild-card characters (? and *) in 
the "filename" argument to indicate that 
attributes of multiple files are to changed. 

SET may also be used to set a drive read-only 
or read/write by specifying a "filename" 
consisting of a drive letter "d:" only. 

If you omit "filename" from the command 
(second form), then the SET command operates 
in an interactive mode. You are prompted by 
an asterisk * to enter a series of directives 
from the console. The syntax of each direc¬ 
tive is: 


I filename {;options} 


Options specified within a directive take 
precedence over options specified in the SET 
command itself. A null directive (RETURN 
only) terminates the SET command. 
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Options 


Examples 


Error Messages 
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The SHOW command lets you display the set¬ 
tings of file attributes. 


I SHOW filename ?options 
I SHOW {;options) 


The SHOW command displays the attributes of 
the file specified by the "filename" argu¬ 
ment . 

You may use wild-card characters (? and *) in 
the "filename" argument to indicate that 
attributes of multiple files are to be dis¬ 
played. 

SHOW may also be used to display the status 
of a drive (read-only or read/write) by spe¬ 
cifying a "filename" consisting of a drive 
letter "d:" only. 

If you omit "filename" from the command 
(second form), then the SHOW command operates 
in an interactive mode. You are prompted by 
an asterisk * to enter a series of directives 
from the console. The syntax of each direc¬ 
tive is: 


I filename (;options) 


Options specified within a directive take 
precedence over options specified in the SHOW 
command itself. A null directive (RETURN 
only) terminates the SHOW command. 
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Options 


Examples 


Error Messages 


Opt ien. 1_Explanation_ 

;L SHOW prints the file attributes 

(rather than displaying them on 

the console). 

;N If "filename" contains wild 

cards, SHOW does not ask you for 
confirmation before displaying 
attributes of each file. 

;Y If "filename" contains wild 

cards, SHOW asks you for confir¬ 
mation before displaying the 
attributes of each file. 


OA KSHOW * . COM ;N 

OArCOPY .COM has attributes: AGR 

0A:DELETE .COM has attributes: AG 

0A:RENAME .COM has attributes: A 

0A}£, HQW -E ; 

Drive B is read-only 
0A }£H£W_Jll 

Drive A is read/write 
0A> 


File not found 
Invalid filename 
Insufficient memory 
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TST490 Command TST490 is utility program for the 490- 

series hard disk controller and the cartridge 
module hard disk drive. 


Syntax I 

I TST490 


Explanation TST490 is a utility program which allows the 

operator to exercise and test a cartridge- 
module hard disk drive and the controller. 

TST490 must be executed in a single-user 
configuration. In systems with banked 
memory, it must be run in bank 0. 

When TST490 is executed, it waits for a com¬ 
mand. Type HELP for a list of all of the 
commands. The INIT command must always be 
executed first. 

Commands - 

I I 
I CYLINDER - Set the current cylinder I 
I number (0-822). Default = 0. I 
I I 
I DISKTEST [loop][all][all loop] - I 
I Performs a read-write-verify of I 
I each sector. [loop] will per- I 
I a continuous test until termin- I 
I ated with an ESC. [all] will I 
I test each sector on the drive I 
I (all surfaces, both volumes). I 
I This test takes several hours I 
I to complete one cycle. I 
I WARNING - This test destroys the I 
I data on the disk. I 
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Commands 

(Continued) 


DUMP [address][BUF][PAGE nl - Displays 
system memory or the on board 
memory of the controller, 
[addresslmay be any valid hex 
address. [BUF] will display the 
controller memory. [PAGE] will 
display any valid system memory 
page (256 bytes) where n is the 
page number (0-255). If n or 
[address] are omitted, the dump 
will begin with page 0. 

ENTER [address] - Enters values directly 
into system memory. If [address] 
is omitted, it starts at 0. A 
period is used to terminate 
ENTER. 

ERROR [error number][ON][OFF][CLEAR] 

[ABORT] - Examine errors. [CLEAR] clears 
the error buffer. [error number] 
is the number of the error to be 
examined. Error logging is dis¬ 
abled with [OFF] and enable with 
[ON]. [ABORT] causes testing to 
stop if an error occurs. [ABORT] 
is reset by INIT. 

FILLBUF [byte] - Fills the controller 
memory with the constant hex 
[byte]. 

FILLMEM [byte] - Fills a section of 

memory with [byte]. The user is 
prompted for the starting and 
ending addresses. 
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FORMAT [all][byte x][all byte y] - 

formats the currently selected 
surface. FORMAT [all! formats 
all surfaces. FORMAT [byte x] 
sets the sector fill byte to the 
new value. [byte x] defaults to 
E5 hex. After formatting, veri¬ 
fication is performed. 

HEAD - Sets the head number. 

HELP - Displays menu of commands. 

INIT - Initializes the program to 
default values. 

INIT [x3 - Changes the interrupt vector 
used by the controller. x may be 
from 0 to 7. Default is 4. 

IPL - Exits the program by executing 
Initial Program Loader 

QUIT - Exits the program by performing 
a warm boot. 

RAMBUF - Changes the address of the 
read/write buffers in system 
memory. 

£EAD [LOOP][count] - Reads the current 
sector to the read buffer. If 
[count] is omitted, only 1 sector 
will be read, else [count] may be 
a decimal value from 1-127. 

READ[LOOP] repeatedly reads the 
current sector. 

SECTOR [sector number] - Sets the 

sector number in the range from 
0 - 31. Default = 0. 
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Commands 

(Continued) 


SEEKTEST [loop][all][all loop] - 

Performs a seektest to each 
sector in the volume. [loop] 
is a continuous test terminated 
by ESC. [all] will check each 
sector on the drive (all sur¬ 
faces, both volumes). 
SEEKTESTtakes several hoursto 
complete one cycle. 

TESTBUF - Tests the controller memory. 
The display can be frozen with 
control-S. 

TRANSFER - Changes the transfer mode 

(DMA or programmed I/O) between 
the controller and system RAM. 
Note that DMA is used only with 
disk read/writes; all other op¬ 
erations use programmed I/O. 

VERIFY - [all][header][hdr][byte x] 

[all header][all byte x] - 

Reads each sector on the selected 
surface. Each sector header is 
checked and the data bytes are 
checked to be E5 hex. tall] will 
test all surfaces on the drive, 
[header] or [hdr] will check only 
the headers. [byte x] will check 
for data [byte] instead of E5. 

VOLUME - Sets the head number on the 
drive. Volume 0 selects the 
removeable surface and volume 1 
selects the fixed surface(s). 
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(Continued) 


WRITE [LOOP][count] - Writes the data in 
the write buffer out to the cur¬ 
rently selected sector. If 
[count] is omitted, only one sec¬ 
tor is written. [count] may be 
a decimal value in the range of 
1-127. WRITE [LOOP] repeatedly 
writes the current sector. 

Warning - This command will des¬ 
troy the data on the disk. 
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TSTF930 Command TSTF930 is a floppy disk utility used for 

testing IMS International 930 floppy control¬ 
lers, drives and floppy diskdettes. 


Syntax - 

I 

I TSTF930 


Explanation The TSTF930 command must be executed in a 

single-user configuration. In systems with 
banked memory, it must be run in bank 0. 

The TSTF930 program executes a number of 
commands which can be used to test your flop¬ 
py controller, drive or disks. To see a list 
of the commands, type HELP after starting the 
program. For an explanation of a certain 
command, type HELP command-name . If you are 
already in the HELP mode, you can type the 
command name for an explanation or press 
RETURN to exit. 
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TSTW is a utility program used to test 
winchester drives. 


I TSTW 


TSTW is a utility program which allows the 
operator to exercise and test a winchester 
disk. 

TSTW must be executed in a single-user 
configuration. In systems with banked 
memory, it must be run in bank 0. 

When TSTW is executed, you will be asked 
to enter the type of winchester on your 
system. You will also be asked if your 
winchester controller has a "fast-seek" 
interface card. This latter question is 
asked only if you entered a 5" Winchester on 
the first question. TSTW will then wait for 
a command. Type HELP for a list of all of 
the commands. The INIT command must always 
be executed first. 


CYLINDER - Set the current cylinder 
number. 

DISKTEST [LOOP][ALL][ALL LOOP] - 

Performs a read-write-verify of 
each sector. [LOOP] will per- 
a continuous test until termin¬ 
ated with an ESC. [ALL] will 
test each sector on the drive 
(all surfaces, both volumes). 
This test takes several hours 
to complete one cycle. 

WARNING - This test destroys the 
data on the disk. 


( 
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DUMP [address][BUF][PAGE nl - Displays 
system memory or the on board 
memory of the controller, 
[addresslmay be any valid hex 
address. [BUF] will display the 
controller memory. [PAGE] will 
display any valid system memory 
page (256 bytes) where n is the 
page number (0-255). If no 
arguments are entered, DUMP will 
default to the Read/Write buffer 
address. 

ENTER [address] - Enters values directly 
into system memory. If [address] 
is omitted, it starts at 0. A 
period is used to terminate 
ENTER. 

ERROR [error number][ON][OFF][CLEAR] 

[ABORT] - Examine errors. [CLEAR] clears 
the error buffer. [error number] 
is the number of the error to be 
examined. Error logging is dis¬ 
abled with [OFF] and enable with 
[ON]. [ABORT] causes testing to 
stop if an error occurs. [ABORT] 
is reset by INIT. 

FILLBUF [byte] - Fills the controller 
memory with the constant hex 
[byte]. 

FILLMEM [byte] - Fills a section of 

memory with [byte]. The user is 
prompted for the starting and 
ending addresses. 
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FORMAT [byte] - formats the entire 

disk. tbyte] changes the current 
sector fill number. [byte] de¬ 
faults to E5H. 

HEAD - Sets the head number. 

XNIT - Initializes the program to 
default values. 

IPL - Exits the program by executing 
Initial Program Loader 

LDPATT - Loads the buffers with the 

"Neal pattern" and inserts a 16 
bit pattern [byte]tbyte] in the 
middle. A prompt is issued for 
the pattern. Use this test only 
for ECC testing; it will destroy 
the header and data on the cur¬ 
rently selected sector. 

QUIT - Exits the program by performing 
a warm boot. 

RAMBUF - Changes the address of the 
read/write buffers in system 
memory. 

READ [LOOP][count] - Reads the current 
sector to the read buffer. If 
[count] is omitted, only 1 sector 
will be read, else [count] may be 
a decimal value from 1-20. 

READ[LOOP] repeatedly reads the 
current sector. 

HECTOR [sector number] - Sets the 
sector number. 
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SEEKTEST [LOOP] - 

Performs a seektest to each 
sector in the volume. [LOOP] 
is a continuous test terminated 
by ESC. SEEKTEST takesseveral 
hours to complete one cycle. 

SEEKVER [ON] [OFF] - Enables/disables 
seek verification. 

TESTBUF - Tests the controller memory. 

The display can be frozen with 
control-S. 

TESTECC [LOOP] - Executes an error 

checking and correcting test. 
[LOOP] will run the test until 
terminated with ESC. Run time 
is approximately one minute. 

VERIFY - [HEADER][HDR][byte] - 

Reads each sector on the selected 
surface. Each sector header is 
checked and the data bytes are 
checked to be E5 hex. [HEADER] 
or [HDR] will check only the 
headers. [byte] will check for 
data [byte] instead of E5. 

WRITE [LOOP][count] - Writes the data in 
the write buffer out to the cur¬ 
rently selected sector. If 
[count] is omitted, only one sec¬ 
tor is written. [count] may be 
a decimal value in the range of 
1-20. WRITE [LOOP] repeatedly 
writes the current sector. 

Warning - This command will des¬ 
troy the data on the disk. 
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TSTWIN Command TSTWIN is an IMS Winchester test utility used 

for testing IMS Winchester drives with IMS 
model 1100 DMA Winchester controllers. To 
use this utility it must be run on a single- 
user system and the Winchester drive(s) must 
have been previously formatted by the FMTWIN 
Format utility. 


Syntax - 

I 

I TSTWIN 


Explanation The program will sign on and display a status 

screen. The status information displayed on 
the screen indicates the following: 

UNIT: the physical unit number of the drive 

(displayed in decimal). 

TRACK: the current track location of the 

drive (displayed in decimal). 

SECTOR: the current sector location of the 

drive (displayed in decimal). 

STATUS: the current status condition of the 

drive (status conditions are defined in "help 
menu"). (Displayed in hex.) 

PROG ID: the name of the utility. 

TEST COUNTER: this counter is only used 

during the "READTEST" and 
"WRITETEST" commands. The first byte 
indicates how many cycles the test has 
completed. The last 3 bytes indicate a count 
of the number of read or read/write 
operations during the execution of the test 
(displayed in hex). 

REV: the revision number of the utility 

(displayed in decimal). 

DMA READ ADDRESS: the address in RAM where 
disk data is transferred TO during a read 
(displayed in hex). 

DMA WRITE ADDRESS: the address in RAM where 
disk data is transferred FROM during a write, 
(displayed in hex) 
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FREE MEMORY: the "from-to" addresses of RAM 
not taken up by TSTWIN or the Operating 
system (displayed in hex) . 

NO.OF TRACKS: the number of tracks contained 
on the drive. (displayed in decimal) 

ERROR COUNTER: the number of errors 

accumulated during program usage. (displayed 
in decimal) 

Most of the commands do not alter data on the 
Winchester. However, there are 3 destructive 
commands. They are "WRITE", "WRITERES", and 
"WRITETEST". 

The "WRITE" and "WRITERES" commands will 
write data from the DMA write buffer to one 
or more sectors or to a full track. Track 0, 
sectors 0-4, and the last 8 tracks of IMS 
Winchesters are "reserved" areas for 
controller firmware and Operating System 
usage. The "WRITERES" command is used to 
write to the reserved areas, and the "WRITE" 
command is used to write to all other areas. 
The "WRITETEST" command will execute a 
destructive read/write test of every sector 
on the Winchester. (Except the reserved 
areas) . 

The "RETRIES" command, although not 
destructive, should be used with caution as 
it can affect the performance of the 
Winchester. The Winchester controller 
firmware is initialized to do 5 retries on a 
read or write request before it interprets an 
error. The "RETRIES" command allows the user 
to temporarily change the number of retries 
done by the firmware. Changing the number of 
retries to 0 or 1 will disable the ECC error 
correction. The "QUIT" command will set 
retries back to 5 when exiting the program. 
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The "RETRIES” command is useful for finding 
soft errors on Winchesters. For example, to 
locate potentially bad sectors, retries could 
be set to 0 and extended "READTEST"s or 
"WRITETEST"s could be run. Bad sectors found 
in this manner could then be assigned to the 
alternate sector table on the drive with the 
FMTWIN utility (if re-formatting the drive) 
or the ALTSEC utility. 
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The TYPE command displays the contents of a 
text file on the console or printer. 


! TYPE filename {;options} 


The TYPE command displays the contents of the 
text file specified by "filename". The 
result may be directed to either the console 
or printer. 


I _Opt i . o n. 1 __Eaplan a .ti.on___I 

I I 
I ;L The file is printed, rather than I 
I displayed on the console. I 


i PA) TYPE B:UPDATE.DOC 
I ...(display of BiUPDATE.DOC)... 
I 0A} 


Error Messages 


I File not found 
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VERIFY Command The VERIFY command scans a disk for bad 

blocks, and (optionally) marks them so that 
TurboDOS will avoid using them. 


Syntax 


Explanation 


Options 


Example 


I VERIFY d: {;options} 


The VERIFY command reads every block on the 
disk identified by "d:", which must be at¬ 
tached to the processor in which the command 
is executed. If bad blocks are detected, 
VERIFY will tell you how many of them were 
encountered, and will ask you whether you 
want them marked. If you answer "yes", then 
VERIFY will create a read-only directory 
entry under the name BLOCKS.BAD to reserve 
the defective blocks and prevent their subse¬ 
quent use by TurboDOS. Use of the VERIFY 
command is restricted to privileged log-ons 
only. 


Option. 1 _Ex planation _ 

;R VERIFY repeats continuously 

(allowing multiple disks to be 
verified) until terminated by 
typing CTRL-C. 


0A> VERIFY B: 

Insert disk to be verified in drive B 
Enter <CR> to begin verifying: [RETURN] 
Verifying blocks on drive: B 


Verify completed - 3 bad blocks found 
Mark bad blocks in directory (y/n)? Y 
Marking bad blocks in directory 
0A) 
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Error Messages 


Non-privileged user 
Unable to execute from bank 1 
No verify drive specified 
Unable to lockout verify drive 
Verify drive not ready 
Insufficient memory to verify 
Excessive bad blocks 
Error marking bad blocks 
Bad directory block 
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WALT is a winchester alternate sector 
utility. 


I WALT {d:} 


WALT provides the capability to create and 
maintain the Alternate Sector Table entries, 
the BLOCKS.BAD directory entries, and the 
Load Parameter Block (LPB). 

WALT will only run in a single-user 
configuration. In systems with banked 
memory, WALT must be run in bank 0. 

The WALT command uses questions and menus to 
quide the user through the program. 

The winchester driver makes use of an Alter¬ 
nate Sector Table which is located on the 
first physical sector of the disk drive and 
set up by the winchester format program, 
FMTW. The fomai. is a four byte entry for 
crack enc sector of each bad sector requiring 
an alternate. Unused entries have a track 
number of OFFFFH. The winchester driver 
assumes that if the first drive has more bad 
sectors than are on track 2 (17 or 18), then 
BLOCKS.BAD directory entries can be used to 
prevent the system from accessing those sec¬ 
tors. 

When changes are made to the Alternate Sector 
Table (which is read into a buffer), WALT 
will prompt the user to write out sector 0 
before exiting. Since Alternate Sector Table 
changes are only made in memory buffers, they 
will have no effect if sector 0 is not writ¬ 
ten out. 
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The Verify Disk function in the Read Only 
mode will sequentially read all the sectors 
from the tracks specified, which verifies 
that the headers and ECC bytes are good. The 
Verify Read and Write function will destroy 
data because it writes a pattern of E5H and 
then reads and verifies all the sectors on 
the tracks specified. If an error occurs, 
the user is given several options which in¬ 
clude making an Alternate Sector Table or a 
BLOCKS.BAD directory entry. 

During any attempt to create a BLOCKS.BAD 
directory entry, the entire directory for the 
logical drive is searched for the block num¬ 
ber specified. If the block is found in a 
directory, the operator is informed of which 
file it was found in and the new BLOCKS.BAD 
directory entry is not made. If the user 
desires, he can stop (ST) the program and use 
system commands to d<-3ele the file if he 
wishes and then recall WALT to add the 
BLOCKS.BAD directory entry. 
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The XON command lets you enable or disable 
the protocol handling for any serial port. 


XON {channel#} (setting) 


In order to run WordStar on an XON/XOFF 
terminal, the serial driver must be told to 
ignore ~S and instead of using them to 

stop and re-start the flow of characters to 
the terminal. Before running WordStar, type: 

XON (channel#) OFF 

After running WordStar, re-enable XON/XOFF 
protocol by typing: 

XON {channel#} ON 

The channel# can be any channel from 0 to 15, 
inclusive. If you omit the channel#, it 
will default to 0, which is the default 
Console Channel. 

If you omit the setting, it will default to 
ON. 


OA)XON 

XON: Channel 0 has Protocol Handling 

turned ON 
OA)XON 15 OFF 

XON: Channel 15 has Protocol Handling 

turned OFF 


I 
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Error Messages - 

I 

I XON: we can't run in Bank 1. Please 
I change to Bank 0. 

I XON: No such channel number. Try 0 
I through 15 (decimal). 


Patch Points None. 
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8086 family: A family of compatible 16-bit microprocessors de¬ 
signed by Intel Corporation, which include the 8086, 8088, 80186 
and 80286. 

abort: Premature termination of a program at your request. 
TurboDOS provides a special attention sequence which enables you 
to abort a program at any time. 

allocation map: The area on a disk where TurboDOS keeps track of 
which portions of the disk storage space are occupied with infor¬ 
mation, and which portions are free. 

application program: Computer program designed for a particular 
application, such as word processing, data management, accoun¬ 
ting, spreadsheet calculations, or statistical analysis. 

archived attribute: An file attribute which indicates that a 
file has not been changed since the last time it was backed up, 
and therefore does not have to be backed up again. 

argument: Variable item in a command which is passed to the 
command program. Arguments may specify a drive, a file name, a 
command option, etc. 

ASCII: American Standard Code for Information Exchange is a code 
used to represent textual information in computers. ASCII de¬ 
fines a standard representation for each letter, digit, and 
punctuation character as a 7-bit binary number. 

attention request: A means for interrupting the execution of the 
program in progress in order to make a request of TurboDOS. In 
most systems, you issue an attention request by keying either 
CTRL-S or CTRL-0. 

attribute: A file characteristic that you can set or clear. 
TurboDOS supports four attributes: archived, read-only, global, 
and FIFO. 

autoload: A facility which allows a program or command sequence 
to be executed automatically without explicit user action. 
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automatic spooling: A printing method in which print output is 
first accumulated in a disk file, then automatically queued for 
background printing. 

backspace: A key on most console keyboards used to correct 
typing errors by deleting incorrect keystrokes. 

backup: Copy of a file or disk made to protect against loss in 
case of human error or equipment failure. Also, the act of 
making such backup copies. 

bad block: Spot on a disk which is defective and unusable. 
TurboDOS allows such bad blocks to be detected, marked, and 
avoided. 

banked memory: A hardware technique in which multiple memory 
banks are installed in a microcomputer, together with a mechanism 
for switching from one bank to another under software control. 
This approach is commonly used to allow more than 64K of memory 
to be used with an 8-bit microprocessor such as the Z80. 

batch processing: Processing under the control of a pre-defined 
sequence of commands (see "do-file"). 

bit: Short for "binary digit" which can take the values 0 or 1, 
the smallest unit of information. (See "byte", "kilobyte", and 
"megabyte".) 

boot tracks: See "reserved tracks". 

buffer: An area of memory used to hold data temporarily during 
processing. TurboDOS provides an elaborate disk buffer facility 
in order to speed performance by reducing the frequency of disk 
accesses. 

byte: Basic unit of information, consisting of 8 bits. A byte 
of information can represent one ASCII character, or an integer 
between 0 and 255. (See "bit", "kilobyte", and "megabyte".) 

cold start: Initial start-up of TurboDOS, which involves reading 
a copy of the TurboDOS operating system from disk into the compu¬ 
ter's memory. 
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command: An instruction you give to TurboDOS, telling it to run 
a particular program. Also, any of the more than 30 standard 
programs furnished with the TurboDOS operating system. 

command prompt: A symbol (e.g., "0A}") displayed on your console 
to indicate that TurboDOS is ready to accept a command. The 
command prompt consists of the current user number (e.g., "0"), 
the current drive letter (e.g., "A"), and the character ">". 

command string: A sequence of TurboDOS commands that you key in 
together on a single line. The commands in a command string must 
be separated by the backslant \ character. 

command tail: Arguments which follow the program name in a 
command. TurboDOS passes the command tail to the program. 

confirmation: Feature of various TurboDOS commands that allows 
you to approve or cancel each file operation before it is done. 

console: Hardware device that allows you to interact with your 
computer, usually consisting of a keyboard and a display screen. 

CP/M: Short for "Control Program/Microcomputers", a widely-used 
operating system for single-user microcomputer systems. CP/M is 
a registered trademark of Digital Research Inc. 

CTRL: A special key on most console keyboards for entering non¬ 
printing control characters. To enter the character "CTRL-X", 
you have to hold down the CTRL key while you press X. 

current drive: The disk drive which is used by default whenever 
you don't specify any drive explicitly. 

cursor: An indicator on your console screen (usually a box or 
underline) which shows you where the next character you type will 
appear. 

data: Any kind of information (numbers, text, formulas, pic¬ 
tures, etc.) that may be used as input to or output from a 
computer program. 

default: The value assumed by TurboDOS implicitly when you do 
not specify an argument explicitly. 
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delimiter: Character that separates one argument or command from 
another. 

de-spooling: Background printing from a print file on disk. 

diagnostic: A message displayed on your console to tell you that 
a processing error has occurred, and often prompting you to 
choose among alternative methods of recovering from the error. 

direct printing: Routing of print output directly to a printer 
on a character-by-character basis. (See "spooling".) 

directory: A table of contents maintained by TurboDOS on each 

disk to keep track of files stored on the disk. 

disk: A rotating magnetic medium used by computer systems to 

store programs and data. (See "floppy disk" and "hard disk".) 

diskette: See "floppy disk". 

do-file: A file containing a pre-defined sequence of TurboDOS 

commands. (See "batch processing"). 

drive: A hardware device which reads and writes on magnetic 

disks, (much as a tape recorder records and plays magnetic tape). 
TurboDOS identifies each drive with a letter between A and P. 

dump: A display or printout of information consisting of the 

hexadecimal representation of each byte of data. (See "hexadeci¬ 
mal"). 

echo-print: A mode in which every character displayed on the 

console is also echoed to the printer. 

FIFO: Short for "first-in, first-out". A special kind of file 

in which data is always written to the end but read from the 
beginning. FIFOs are used mostly for inter-processor and inter¬ 
user communications. 

FIFO attribute: File attribute which designates that a file is 
to be accessed using the special FIFO access method. 
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file: Collection of related information stored on disk. Files 

may contain programs or data. 

file attribute: See "attribute". 


file lock: Mechanism to prevent several users from trying to 
access or modify a file at the same time. 

file name: The name you assign to a file so that you can identi¬ 
fy it later. TurboDOS keeps track of your files by name. 

file type: An optional extension to a file name used to group 
similar files together. 

floppy disk: Inexpensive removable disks which use a flexible 
magnetic medium that spins inside a cardboard jacket. Floppy 
disks come in 8-inch and 5.25-inch diameter sizes (smaller ones 
are being introduced). They may be recorded on one or both 
sides, and commonly have capacities of 150 to 1,500 kilobytes. 

format: The way in which data on disk is organized into tracks 
and sectors. Also, the process of initializing a disk with the 
desired format. 

global attribute: File attribute which designates that a file 
saved under user number 0 is to be accessible from any user 
number. Global files provide a convenient way to make selected 
files available to all users. For example, TurboDOS commands and 
other common programs are often given the global attribute. 

hard disk: High-performance disks which use one or several rigid 
magnetic platters which spin inside a sealed chamber. Hard disks 
offer much greater storage capacity than floppy disks, typically 
5 to 50 megabytes or more. 

hard sectored: Disk whose format is fixed by the hardware 
itself. 

hardware: Physical equipment comprising a computer system (as 

distinguished from the programs that run on it). 
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hashed directory: A directory format that uses a sophisticated 
technique to make directory look-up much faster than possible 
with a linear directory. Hashed directories are especially 
suited for use on hard disks with big directories. 

hexadecimal: Numeric notation using base 16, which is often a 
convenient way to represent non-textual information. The sixteen 
hexadecimal digits are represented by the characters 0-9 and A-F. 


incremental backup: An efficient backup procedure whereby backup 
copies are made only of files which have been created or modified 
since the last backup cycle. (See "archived attribute".) 

kilobyte: Unit of information consisting of 1,024 bytes and 
abbreviated by the letter "K". Each page of this document con¬ 
tains about 3K of information. (See "byte".) 


linear directory: A simple directory format compatible with CP/M 
and suitable for use on floppy disks. (See "hashed directory".) 


local command: A command which requires direct access to disk 
drive and controller hardware, and consequently may be executed 
only in the processor to which the disk is attached. 

log-off: Procedure for terminating a console session on a multi¬ 
user system. After log-off, a log-on is required before your 
console can be used again. (See "log-on".) 

log-on: Procedure for starting a console session on a multi-user 
system. You must identify yourself by entering your user-id and 
possibly a security password before TurboDOS will allow you to 
make use of the computer. 


loosely-coupled network: Multi-processor system in which the 
various processors are physically separated (often built into 
user consoles), and connected with some sort of communications 
path. 

manual queuing: Submitting files for background printing by 
using the QUEUE command. 
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manual spooling: A printing method in which print output is 
accumulated in a disk file, but no t automatically queued for 
background printing. 

master processor: In a networking system, a processor whose 
primary function is to manage disk drives, printers, and other 
shared peripherals on behalf of other (slave) processors. 

megabyte: Unit of information consisting of 1,024 kilobytes 
(1,048,576 bytes). The entire set of TurboDOS manuals contains 
roughly a megabyte of information. (See "byte" and "kilobyte".) 

memory: Hardware in a computer system which stores information. 
(See "random-access memory".) 

MP/M: Multi-user version of the CP/M operating system, which 
uses time-sharing to support multiple users. MP/M is a regis¬ 
tered trademark of Digital Research Inc. (See "CP/M", "time¬ 
sharing ".) 

multi-processor: System composed of several microcomputers net¬ 
worked together. (See "microprocessor", "networking".) 

multi-user: System capable of supporting several user activities 
at several consoles simultaneously. (See "networking", "time¬ 
sharing" .) 

nested do-file: A do-file executed from within another do-file. 

networking: Coordinating a system of interconnected microcompu¬ 
ters. Generally, a separate microcomputer supports each user 
console. One or more additional microcomputers manage the disks, 
printers, and other shared devices of the system. 

operating system: A program which supervises the operation of 
application programs, and which manages memory, disk drives, 
consoles, printers, and other hardware resources of a computer 
system. TurboDOS is an operating system. 

parameter: A place-marker in a do-file that indicates where a 
variable argument is to be substituted when the do-file is exe¬ 
cuted. (See "argument", "do-file".) 
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password: A security code used to validate a user-id during the 
log-on procedure. (See "log-on", "user-id".) 

peripheral device: A hardware device attached to a microcomputer 
for purposes of input or output of information. Typical peri¬ 
pheral devices include disk drives, consoles and printers. 

print job: A unit of printed output, generally the output pro¬ 
duced by one application program. 

print queue: A list of print jobs to be printed in the back¬ 
ground. 

printer: Hardware device that produces printed hardcopy of tex¬ 

tual information. 

privileged log-on: A user who has logged-on successfully to a 
privileged user-id, enabling him to access various protected 
commands and features of TurboDOS. 

program: Instructions for performing a processing task, coded so 

that they can be interpreted by the computer hardware. 

prompt: Symbol displayed on the console by a program to advise 

you what to do next. 

queue: See "print queue". 

random-access memory (RAH): The primary high-speed memory of a 
microcomputer, used to hold programs in execution and data being 
processed. 

read-after-write: When writing data to disk, immediately reading 
it back to make sure it was recorded properly. 

read-only attribute: File attribute which designates that a file 
may be read but not modified or deleted. This helps you protect 
important files against accidental distruction. A drive may also 
be set read-only. 

record: Grouping of related data within a file. In TurboDOS, 

often refers to a block of data 128-bytes long. 
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record lock: Mechanism to prevent several users from trying to 
access or modify the same record of a file at the same time. 

recovery: Procedure to restart processing after encountering an 

error. 

remote console: Using a console attached to a slave processor to 
control activities in a master processor. 

reserved tracks: Designated tracks on a disk required by certain 
hardware configurations to support system start-up, and not 
otherwise used by TurboDOS. 

sector: Portion of a track on disk. A disk is formatted into a 
fixed number of sectors per track. 

server processor: See "master processor". 

slave processor: In a networking system, a processor whose 
primary function is to interact with a console and run applica¬ 
tion programs. (See "master processor".) 

soft sectored: Disk whose format is determined by pre-recording 
formatting information onto the disk. 

software: Computer programs (as distinguished from the hardware 

they run on). 

spooling: Routing of print output to a disk file, instead of 

directly to a printer. (See "de-spooling", "direct printing".) 

syntax: Format for entering a given command. 

tightly-coupled network: Multi-processor system in which the 
various processors are co-located. (See "loosely-coupled net¬ 
work".) 

time-sharing: Technique for supporting multiple users with one 

microprocessor, whereby the processing time of the single proces¬ 
sor is shared among the various users. 

track: Concentric ring on a disk, upon which data is magnetical¬ 

ly recorded. A track is subdivided into sectors. 
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transient program area (TPA)s Memory space available to run 
commands and application programs. 

user-id: Identification of an authorized user, used for security 

purposes on a multi-user system. 

user number: Number from 0 to 31 assigned to a file which it is 
created. User numbers can be used to organize files into sepa¬ 
rate libraries. 

volume label: The name you assign to a particular disk. 

warm start: Termination of a command or application program. 

wild card: Special characters (? and *) used in a file name to 
match any character in the corresponding position. 

Winchester disk: A non-removable form of hard disk, in which 
rigid magnetic platters spin inside of a hermetically sealed 
vessel to ensure freedom from contamination. 

word processor: An application program designed for composing, 
editing, printing, and otherwise manipulating text. 

Z80: An 8-bit microprocessor created by Zilog, Inc. 


( 
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INDEX 


8086 microprocessor, 1-5, 4-12 


abort request, 1-11 
activity (log-on), 1-7, 5-46 
allocation map, 2-16, 5-35 
ALTSEC Command, 5-2 
archived attribute, 2-24, 
5-17, 5-65 

ASCII file dump, 5-30 
attention request, 1-11, 3-3, 
5-33, 5-48 
attribute 

archived, 2-24, 

5-17, 5-65 
FIFO, 2-24, 5-65 
global, 2-23, 5-65 
read-only, 2-23, 5-65 
attributes, 2-23, 5-64 
autoload facility, 4-7, 
AUTOLOAD command, 4-7, 5-4 
automatic spooling, 3-6 

BACKSPACE key, 1-10 
backup, 2-9, 2-24 


bad blocks, 5-85 
BANK command, 5-6 
banked memory, 1-5, 4-11, 5-6 
BATCH command, 5-7 

batch processing, 4-3 
batch queue, 5-7 
BLOCKS.BAD, 5-85 
BOOT command, 2-16, 4-8, 4-12, 
5-9 

boot tracks, 2-16, 5-9 
BUFFERS command, 5-11 


CHANGE command, 2-19, 5-13 
CLOCK Command, 5-14 
cold start, 1-6, 4-7 
COLDSTRT.AUT, 4-7 
command 

format, 1-8 

prompt, 1-6, 1-7 
processing, 4-1 
strings, 1-9, 4-2 
syntax, 1-8, 5-1 
tail, 4-1 
commands, 1-8 
commands 

simple, 4-1 
local, 4-8 
compatibility, 1-2 
confirmation 
in COPY, 5-16 
in DELETE, 5-23 
in QUEUE, 5-57 
in RENAME, 5-60 
in SET, 5-64 
in SHOW, 5-66 
console 

input from do-file, 4-4, 
5-27 

printing to, 3-7, 5-50 
remote, 4-9, 5-40 
COPY command, 2-7, 2-11, 2 
5-16 

COPYF command, 2-9, 2-10, 

CP/M, 1-2 

CTRL-H, 1-10 

CTRL-U, 1-10 

CTRL-X, 1-10 

current drive, 2-5, 2-6 

cursor, 1-10 


INDEX 


- 22 , 

5-20 
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date, 1-7, 5-22 
DATE command, 5-22 
de-spooling, 1-4, 3-2, 3-5, 
3-9, 5-52 
DEL key, 1-10 
DELETE command, 2-8, 5-23 
diagnostic message, 1-4 
DIR command, 2-3, 2-18, 5-25 
direct printing, 3-1, 3-6, 

directory 

disk, 2-3, 2-17 
display, 5-25 
hashed, 2-18, 5-33, 5-34 
linear, 2-18, 5-33, 5-34 
disk, 2-1 
disk 

capacity, 1-3 

directory, 2-3, 2-17, 5-25 
errors, 2-19 
formats, 2-13 
organization, 2-16 
floppy, 1-3, 2-11 
hard, 1-3, 2-11 
reserved tracks, 5-9 
DO command, 4-3, 5-27 
do-file, 4-3, 5-27 
do-files 

console input, 4-4, 5-27 
nested, 4-6, 5-27 
parameters, 4-5, 5-28 
DRIVE command, 2-17, 5-29 
drive 

current, 2-5 
read-only, 2-24, 5-65 
search, 2-25 

selection, 2-5 
DUMP command, 5-30 


echo-print request, 1-11 
editor, 2-6 

end-print request, 1-11, 3-3 
ERASEDIR command, 2-15, 2-18, 
5-31 
errors 

correcting keyboard, 1-10 
disk read and write, 2-19 
spooler, 3-11 
exclusive sharing, 2-26 

FIFO 

as batch queue, 5-7 
attribute, 2-24, 5-65 
files, 5-32, 5-63 
FIFO command, 5-32 
file 

attribute, 2-23, 5-64, 5-66 
lock, 2-26 
name, 2-2 
searches, 2-25 
sharing, 2-26 
type, 2-2 
files, 2-1 
files 

copying, 2-7 
creating, 2-6 
deleting, 2-8 
renaming, 2-8 

FIXDIR command, 2-17, 2-18, 
5-33 

FIXMAP command, 2-16, 5-35 
floppy disk, 1-3, 2-11 
FMTF command, 5-37 
FMTW command, 5-40 
FMTWIN command, 5-42 
format of disk, 2-13 

global attribute, 2-23, 5-65 


i 


B-2 



TurboDOS 1.4 
User's Guide 


INDEX 

(Continued) 


Copyright 1984 by Software 2000, Inc. 
All rights reserved. 


hard disk, 1-3, 2-11 
hard-sectored, 2-13 
hardware, 1-5 

hashed directory, 2-18, 5-31, 
5-33 

hexadecimal file dump, 5-30 

incremental backup, 2-24 

kilobyte, 1-5, 2-3 

LABEL command, 2-15, 2-16, 

5-44 

linear directory, 2-18, 5-33, 
5-33 

local command, 4-8 
lock 

file, 2-26 
record, 2-26 
log-on, 1-6, 1-7 
LOGOFF command, 5-45 
LOGON command, 4-7, 5-46 
loosely-coupled network, 1-5 


manual queuing, 3-4, 3-8, 5-53 
manual spooling, 3-4, 3-7 
map (allocation), 2-16, 2-17 
MASTER command, 4-9, 5-48 
master processor, 5-48 
megabyte, 1-5 
memory banks, 4-11 
memory management, 4-9 
memory size, 1-5 
MP/M, 1-2 

multi-processor, 1-5 
nested do-files, 4-6, 5-27 
networking, 1-2, 1-5, 4-8 
non-banked memory, 4-10 
not ready error, 2^20 

offline (printing to), 3-7 
operating system, 1-1 


parameters in do-files, 4-5 
password, 1-7, 5-46 
performance, 1-3 
permissive sharing, 2-26 
PRINT command, 3-6, 5-50 
print 

job, 3-3, 3-10 
queue, 1-4, 4-4 
routing, 3-6, 5-50 
spooling, 1-4 

PRINTER command, 3-9, 5-52 
printing 

methods, 3-1 
direct, 3-1, 3-6 
spooled, 3-2 
to console, 3-7 
to offline, 3-7 
privileged log-on, 2-22, 5-46 
processing 
batch, 4-3 
command, 4-1 
prompt, 1-6 
PRTWIN command, 5-54 
PUTLDR command, 5-56 
queue 

assignment, 3-9, 5-52 
print, 1-4, 3-3 
QUEUE command, 3-8, 5-53 
queuing manually, 3-4, 3-8, 
5-53 

random-access memory, 4-9 
read error, 2-19 

read-after-write, 1-3 
read-only attribute, 2-23, 
read-only drive, 2-24, 5-65 
RECEIVE command, 5-59 
record locks, 2-26 
recovery options, 1-4, 2-19 
reliability, 1-3 
remote console, 4-9, 5-48 
RENAME command, 2-8, 5-60 
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organization of disk, 2-14 

search drive, 2-25 
searching for files, 2-25 
SEND command, 5-63 
server processor, 5-48 
SET command, 2-23, 5-64 
sharing files, 2-26 
SHOW command, 5-66 
sign-on, 1-6 

single processor system, 1-5 
slave processor, 5-48 
soft-sectored, 2-12 
spooling, 1-4, 3-2 
spooling 

automatic, 3-6 
errors, 3-11 
manual, 3-4, 3-7 
strings of commands, 4-2 
SYSLOG.SYS, 5-45, 5-47 

tightly-coupled network, 1-5 
time, 1-7, 5-22, 5-47 
time-sharing, 1-2, 1-5 
transient program area (TPA), 
4-9, 4-10, 4-11, 4-12 
TST490 command, 5-68 
TSTF930 command, 5-73 
TSTW command, 5-74 
TSTWIN command, 5-78 
TYPE command, 5-81 


reserved tracks, 2-16, 5-9 
RESET command, 5-62 
user-id, 1-7 
user number, 2-21, 5-1 
user number 

copy to/from different, 5-16 
directory of different, 5-24 
USERID.SYS, 5-45, 5-46 

VERIFY command, 4-8, 4-12, 
5-82 

volume label, 2-16, 2-17, 5-44 
WALT command, 5-84 
warm start, 4-7 
WARMSTRT.AUT, 4-7, 5-47 
wild card characters, 2-4, 

2-7, 2-8, 2-18, 5-16, 
5-23, 5-57, 5-60, 

5-64, 5-66 

Winchester disk, 2-13 
word processor, 2-6 
write error, 2-19 

Z80 microprocessor, 1-5 
Z80 memory 

non-banked, 4-10 
banked, 4-11 
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AUTOLOAD 

command 

DUMP 

BANK 

bank number 

ERASEDIR 

BATCH 

command-string 

FIFO 

BOOT 

source destination 

FIXDIR 

♦BUFFERS 

(Nnn Sss) 



nn - number 
ss - size 

FIXMAP 

FMTF 

CHANGE 

drive-list 


♦CLOCK 

;option 

M - Military time 

R - Read and siplay 
date and time 

S - Set time 

V - View always 


COPY 

source dest ;options 



A - archived only 

B - multi-disk files 

♦FMTW 


C - change media 

E - erase 

LABEL 


R - replace files 

Snn - source user # 

LOGOFF 


X - non-existibg 

Y/N - confirm 

LOGON 

MASTER 

♦COPYF 

source: dest: 

PRINT 

DATE 

(SET) 


DELETE 

file ;option 

Y/N - confirm 


DIR 

file ;option 

Y/N - confirm 



L - print 

PRINTER 

DO 

filename (arg-list) 


DRIVE 

drive ;option 

L - print 



QUICK REFERENCE 
GUIDE 


filename ?option 
L - print 

drive: 

filename 

drive: 

drive: 

drive: ?option 
C - CP/M sectors 
T - TurboDOS sectors 
S - single-density 
D - double-density 

1 - single-sided 

2 - double-sided 
V - Verify only 
4-40 cylinders (5") 
8-80 cylinders (5") 

drive: 

label-name 


(key-1...key-n) 
C(ONSOLE) 

D(RIVE)=drive letter 
F(ILE) 

O(FF) 

P(RINTER) 

Q(UEUE) =queue letter 

letter (key-1...key-n) 
B(EGIN) 

G (0) 

0(FFLINE 

Q(UEUE)=queue letter 
S(TOP) 

T( ERMINATE) 
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PUTLDR 

source: dest: 

SHOW 

filename ;options 

L - print 

QUEUE 

filename ;option 

D - delete 


Y/N - confirm 


Q = queue letter 

**TST490 



S - save 

Y/N - confirm 

**TSTF930 

(N) 

N - no help messages 

RECEIVE 

filename 


loaded 

RENAME 

old new ;option 

Y/N - confirm 

**TSTW 




TYPE 

filename ;option 

b RESET 

slavelist 


L - print 

SEND 

filename message 

VERIFY 

drive: ?option 

R - repeat 

SET 

filename yoption 
+/-A - archived 

**WALT 

drive: 


+/-F - fifo 




+/-G - global 
+/-R - read only 
Y/N - confirm 




* = Attach to the MASTER processor to use. 

In systems with banked memory, run in bank 0. 

** = Run in a single-user system 
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